DocsProduction
Limits
Pine applies two kinds of limits:
- Project quotas are set for each project: how many Computers it runs and starts, and how long they run.
- Computer limits come with the project's Computer class: what one session, file or agent turn may use. Each project uses one class: Standard, or a more advanced class that adds features, such as Pause and Resume, and higher limits.
The Usage and quotas tab of your project's page in the Console shows both, and Pine changes them when you ask.
Project quotas
| Quota | Standard | How it's counted |
|---|---|---|
| Concurrent Computers | Set when your project is approved | How many of the project's Computers can exist at the same time. Starting, running and paused ones count; stopped ones don't. |
| Computer starts per minute | 10 | How many Computers the project can start in any rolling minute. A retried start with the same create_id counts once. |
| Idle timeout | 1 minute to 24 hours; 30 minutes by default | Set on each start. Commands, API browser actions, agent turns and desktop-token mints reset it, and it doesn't run out while a person holds control of a session (unless the control timer is paused). Reads and status checks don't reset it. |
| Running time | 7 days per start | Counts from the start, paused time included. Activity doesn't extend it. |
To change a quota, use Request more beside it on the Usage and quotas tab, and say which value you need. A new idle-timeout allowance or running time applies to Computers started afterwards; running Computers keep the limits they started with. More countries, Shell access and other options are on the Capabilities page.
Computer limits
| Limit | Each Computer |
|---|---|
| Sessions at once | 3 |
| Tabs | 10 per session: the API opens a tab only while the session has fewer, though sites and people can open more |
| Agent turns at once | 1 per session |
| A file the agent returns | 100 MiB |
| A file you attach to an agent run | 64 MiB |
| An agent turn's working time | 60 minutes unless you set max_wall_ms; waiting for your answer doesn't count |
A command (exec) |
24 hours unless you set timeout_ms |
| Saved browser state (cookies, passkeys, learned skills) | 20 MiB |
| Artifacts | 100 GiB of files. A single file is limited only by the disk of whatever saves or reads it |
| A public link to an artifact | Works while the Computer runs, for at most 30 days |
These are the Standard class's limits, the base every project starts with. More advanced classes add features and raise these together, on a different plan; to ask for one, use Request a more advanced class on the Usage and quotas tab. Larger files in and out of a session are coming; to tell Pine you need them, request Large files on the Capabilities page.
Each session has its own browser window, shell, files and agent; open one for each task you run at the same time.
Read your limits from code
- Before a start,
client.project_policy(Ruby),client.project_policy()(Python),client.ProjectPolicy(ctx)(Go) orclient.projectPolicy()(TypeScript) returns the project's idle-timeout allowance, running time and Concurrent Computers quota. - On a running Computer,
computer.capabilities(Ruby),computer.capabilities()(Python),computer.Capabilities(ctx)(Go) orcomputer.capabilities()(TypeScript) reports its session, file and agent limits; the API reference has the full response. sandbox_details(SandboxDetailsin Go) gives a running Computer's own idle timeout and the time it must stop by.
When you reach a limit
| Limit | What you get | What to do |
|---|---|---|
| Concurrent Computers | The start is refused (CapacityExceededError, 429) and nothing is created. |
Stop or delete a Computer, or queue the work and start it later. |
| Computer starts per minute | The start is refused (CreateRateLimitedError, 429) with the seconds to wait. |
Wait that long, then start again. |
| Idle timeout | The Computer stops. | Start it again to restore its sign-ins, passkeys and skills; open tabs and session files aren't kept (Persistence). Set a longer timeout for work with long pauses. |
| Running time | Pine starts a graceful Stop twelve minutes before the limit. | Stop and Start at a safe point before then, after downloading the files you need. |
| Sessions | The new session is refused (409). |
Close a session you've finished with. |
| File size | That request is refused (400 or 413). |
Split or compress the file. |
| Artifacts | Saving and uploads are refused (ArtifactStorageFullError). The total is checked about every 30 minutes, so a burst of saves can pass it. |
Delete files the Computer no longer needs. |
Troubleshooting covers each error in more detail.