Plans and limits
Plans are priced by number of agents, not by the hour. A sleeping agent is free to keep: only agents awake at the same time count against your plan. 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 |
| 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 | |
| 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