Documentation
Welcome to the Aiqaramba documentation. Here you will find everything you need to get started and work with Aiqaramba. If you are a new user, begin with the Getting Started guide. If you need details about a specific endpoint, see the API reference.
What is Aiqaramba?
Aiqaramba is a test automation platform that automates the most time-consuming part of testing: manual human testing. Aiqaramba allows you to describe your tests using simple human language, and our agents can execute these tests in real browsers and on mobile devices. This frees your QA people to perform meaningful, high-level work instead of boring, routine validation work. Our agents can handle a much broader class of tests than classic unit tests or browser testing scripts can. They are ideal for replacing routine checks that are too complex to encode in a script but too boring to be performed manually every time.
In a world where coding agents have become ubiquitous, code generation has become cheap, while quality has frankly not kept pace. We built Aiqaramba for people who care about the quality of their software. We believe they deserve the same quality of tooling and software that software developers get to enjoy.
Tests in Aiqaramba are fundamentally prompts that are fed to an agent. They therefore do not suffer from the same problems as other testing approaches:
- Modern LLMs can deal very well with vagueness. There is no need to specify a script that clicks the button with the ID #btn-login. Instead, you can instruct Aiqaramba agents to just "log in," and they will be able to figure it out.
- Aiqaramba tests survive major code changes and need less maintenance. A test that instructs an agent to attempt a password reset and perform basic input validation checks will survive no matter what major changes you make to the page.
- For more complex tests, you would almost need a human to perform the task, as encoding it in a script would become a maintenance nightmare. Aiqaramba has advanced tooling in place that allows you to construct very complex testing flows in which individual steps depend on one another. See test plans.
- While most modern QA tries to automate as much as possible, there is simply nothing that beats an actual human going through the application. A testing script can never really replace this. The problem is that this takes a huge amount of time and is usually the first thing that gets dropped when deadlines are pressing. Be honest: have you checked whether the password reset flow still works after each push to production and does not have a weird CSS bug? Aiqaramba shines at taking over this kind of work, allowing humans to do what they are best at: high-level thinking, product expertise, judgment, and taste.
Guides
Start here to learn the concepts and get your first tests running.
Core Concepts
Understand the building blocks: projects, tests, agents, mailboxes, and more.
Getting Started
Set up projects, mailboxes, and tests from scratch.
LLM Quickstart
Let your coding agent read the API docs and wire up Aiqaramba for you.
Writing Effective Tests
Write prompts that produce reliable, meaningful test results.
For developers
If you are the kind of person who skips the tutorial and goes straight to the API docs, we respect that. Here is your API reference and you can grab an API key from your account settings. Go build something cool.