Plans and limits
Plans are priced by number of agents, not by the hour. Your plan has two numbers: the agents you can keep, awake or asleep, and how many can run at once. A sleeping agent keeps its place and costs nothing extra, but it does not use a running slot. Prices are on the pricing page.
What a plan includes
| Plan | Agents | Awake at once | Desktops and options |
|---|---|---|---|
| Free | 3 | 1 | No |
| Solo | 10 | 2 | Yes |
| Builder | 20, more at €1 each | 5 | Yes |
| Team | 100, more at €1 each | 25 | Yes |
| Enterprise | Custom | Custom | Yes |
Running slots
When all your slots are taken and you talk to a sleeping agent, the agent of your account that has been idle the longest goes to sleep to make room. You never have to manage it. If every awake agent is busy at that moment, the API answers 429 with a Retry-After header: retry a few seconds later.
- An agent with a desktop uses two slots.
- An always-on agent (
idle_s: 0, a paid option) has its own slot and does not count. - On the Free plan agents always sleep when idle, after one hour at most. The default everywhere is five minutes.
The machine
| Default | Maximum | |
|---|---|---|
| Processors | 2 vCPU | 4 vCPU |
| Memory | 2 GB | 8 GB |
| Disk | 8 GB | 100 GB |
| Network | 50 Mbit/s on Free, 250 Mbit/s on paid plans |
On paid plans you can size an agent up at any time, from its settings or with PUT /agents/{id}/size. The agent restarts in about three seconds with its files, variables and conversation. A disk can only grow. On the Free plan a machine gets one processor core's worth of compute.
Options are billed per agent, per month, on paid plans:
| Option | Price |
|---|---|
| 4 GB of memory | +€3 |
| 8 GB of memory | +€9 |
| 20 GB of disk | +€4 |
| 50 GB of disk | +€12 |
| 100 GB of disk | +€25 |
| Always on | +€10 |
Outgoing port 25 is closed on every machine. Agents cannot reach each other, the host, or private networks.
Errors you may see
| Code | Meaning | What to do |
|---|---|---|
| 401 | Unknown, revoked or expired key or session | Create a new key, or sign in again |
| 402 | Your plan does not include this: too many agents, a desktop, a bigger machine, always on, or an unpaid invoice | Upgrade, delete an agent, or settle the invoice |
| 402 on a message | This agent reached its spend cap. Its status is capped | Raise its cap in its settings, or with PUT /agents/{id}/env |
| 403 | The key lacks the scope this route needs | Create a key with the right scope |
| 404 | The agent does not exist, or belongs to another account | Check the id with GET /agents, and that the key belongs to the right account |
| 429 | All running slots are busy, or too many requests | Retry after the delay in Retry-After |
If a payment fails
Nothing is deleted. You have 14 days to fix it. After that your agents go to sleep with their files and checkpoints intact, and they wake up as soon as the payment goes through.
Next: the CLI