Orgo - Cloud computers for AI agents

Every Orgo computer gets the CPU and RAM you ask for when you create it. Choose the size that fits your workload.

Available instances

POST /computers takes no size name. A computer’s size is the cpu, ram, and disk_size_gb you send. The names below are the sizes Orgo’s price list prices. The dashboard offers Medium and up. Small is API-only.

Size	vCPU	RAM	Disk	Create with
Small	0.5	4 GB	20 GB	`"cpu": 0.5, "ram": 4, "disk_size_gb": 20`
Medium	2	8 GB	40 GB	`"cpu": 2, "ram": 8, "disk_size_gb": 40`
Large	4	16 GB	80 GB	`"cpu": 4, "ram": 16, "disk_size_gb": 80`
XL	6	32 GB	150 GB	`"cpu": 6, "ram": 32, "disk_size_gb": 150`
2XL	8	64 GB	300 GB	`"cpu": 8, "ram": 64, "disk_size_gb": 300`

XL is the largest size you can create on your own. 2XL is set up on request, as described in Accepted values. Send only ram and you get that size’s vCPU: 2 for 8 GB, 4 for 16 GB, 6 for 32 GB, and 8 for 64 GB. Omit both cpu and ram and you get 1 vCPU and 4 GB, unless you create from a template, which sets its own size. Omit disk_size_gb and you get your plan’s default disk. Your plan caps each computer, so a size above its ceiling is refused until you add capacity, as described in Accepted values. A Linux computer boots at 1280x720 unless you pass resolution. Linux is the default operating system. Set os on create to choose another.

Usage

Pass cpu and ram when creating a computer to select its size:

# A Medium. Replace $WORKSPACE_ID with the workspace to create it in.
curl -X POST https://www.orgo.ai/api/computers \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"workspace_id": "'"$WORKSPACE_ID"'", "name": "agent-1", "cpu": 2, "ram": 8, "disk_size_gb": 40}'

from orgo import Computer

# Medium
computer = Computer(ram=8, cpu=2)

# Large
computer = Computer(ram=16, cpu=4)

# XL: send ram alone and the API gives it 6 vCPU
computer = Computer(ram=32)

import { Computer } from 'orgo';

// Medium
const medium = await Computer.create({ ram: 8, cpu: 2 });

// Large
const large = await Computer.create({ ram: 16, cpu: 4 });

// XL: send ram alone and the API gives it 6 vCPU
const xl = await Computer.create({ ram: 32 });

The SDKs take a cpu of 0.5, 1, 2, 4, 8, or 16, not 6, so create an XL by passing ram of 32 alone, as above. They send no disk size, so a computer made with one gets your plan’s default disk. Choose a disk size over HTTP. Leave out ram and cpu and the SDKs send neither, so you get the default size above. SDK versions before 0.0.47 (Python) and 1.0.22 (TypeScript) default to 2 GB, which the API rejects, so pass ram and cpu to those.The TypeScript SDK ships in version 1 of the orgo npm package. Install it with npm install orgo@1. Version 2 and later of orgo contain only the CLI.

Accepted values

POST /computers validates ram, cpu, and os before it provisions anything. A value outside the sets below returns 400 with the accepted set in the message, for example {"error": "cpu must be 0.5, 1, 2, 4, 6, 8, or 16 cores"}. Omit any of the three and you get the default. Clearing that check is not the whole story. On your own, one computer goes up to XL: 6 vCPU and 32 GB RAM. A larger computer returns 403 with code CONTACT_US_FOR_SIZE, and Orgo sets it up on request. No computer goes above 8 vCPU, 64 GB RAM, or 300 GB of disk, on any plan. Within those limits, a computer draws on your account’s RAM and vCPU. See RAM and vCPU on your plan.

RAM

Integer, optional, in GB. Defaults to 4.

Value	Description
`4`	4GB (default)
`8`	8GB
`16`	16GB
`32`	32GB (XL, the most you can create on your own)
`64`	64GB (2XL, the per-computer cap, set up on request)

Anything else returns 400: {"error": "ram must be 4, 8, 16, 32, or 64 GB"}. 64 clears the value check, then returns 403 with code CONTACT_US_FOR_SIZE unless Orgo has set your account up for computers past XL. A macOS computer takes only 10, which is also its default. Any other value returns 400 with code MACOS_RAM_FIXED: {"error": "macOS computers have 10 GB RAM. Contact us for more.", "code": "MACOS_RAM_FIXED"}.

A request inside the table above can still be refused with 403 when your account has no room for it. See RAM and vCPU on your plan.

CPU

Number, optional, in cores. Defaults to 1, or to the vCPU of the ram you send, as described in Available instances.

Value	Description
`0.5`	Half a core
`1`	1 core (default)
`2`	2 cores
`4`	4 cores
`6`	6 cores (XL, the most you can create on your own)
`8`	8 cores (2XL, the per-computer cap, set up on request)
`16`	Accepted by the value check, then refused with `403`

Anything else returns 400: {"error": "cpu must be 0.5, 1, 2, 4, 6, 8, or 16 cores"}. 8 returns 403 with code CONTACT_US_FOR_SIZE unless Orgo has set your account up for computers past XL:

{
  "error": "Computers larger than 6 vCPU and 32 GB are set up on request. Contact us.",
  "code": "CONTACT_US_FOR_SIZE",
  "upgradeTier": "enterprise",
  "canManageCapacity": true,
  "max_cpu": 6,
  "max_ram_gb": 32
}

16 is in the accepted set, so it clears the value check. It then fails with 403 and code PER_COMPUTER_CPU_CAP on every plan, because no computer goes above 8 vCPU.

OS

String, optional. Defaults to linux.

Value	Description
`linux`	Linux (default)
`windows`	Windows
`macos`	macOS
`android`	Android
`ios`	iOS on a physical iPhone, not a virtual machine

Anything else returns 400: {"error": "os must be one of: linux, windows, macos, android, ios"}. A non-Linux computer is placed on a host that can boot that guest, so capacity for it is narrower than for Linux.

Resolution

Resolution is passed as a string in WIDTHxHEIGHTxDEPTH format. Default is 1280x720x24, or 1920x1080x24 on macOS. A computer created from a template uses the template’s resolution.

1024x768x24
1280x720x24
1920x1080x24

Persistence

A computer’s disk and files persist across stop/start. Stopping a computer archives its disk. Starting it again restores your files and installed software, on the same host when Orgo can place it there. If it lands on another host, its IP can change. In-memory state and running processes are not preserved. Computers run until you stop them or turn on auto-stop. A free account’s hourly computer stops when its credit runs out. Its files are kept for 7 days.

Included with every instance

All instance types share these capabilities:

Full REST API and SDK access
Screenshot, mouse, keyboard, and bash execution
File upload and download
VNC access

RAM and vCPU on your plan

Instance type sets the resources of one computer. RAM is per computer, with a total for the account:

Plan	Computers	RAM in total
Starter	1	8 GB
Growth	4	32 GB
Scale	16	128 GB

One computer can use any of that total, up to 32 GB on your own, so on Scale that is 16 computers at 8 GB, or 4 at 32 GB. vCPU is also a pool for the account. A create that does not fit returns 403 with code RAM_ADDON (RAM) or VCPU_ADDON (vCPU). A free account has no plan. Its $5 of signup credit runs one Medium Linux computer by the hour. See Orgo pricing for prices and seats.

Scaling and limits

Your Usage page shows what you have in use against your limits. Add computers, RAM, vCPU, and storage on Plan & billing, or with the capacity API. If you’re planning a large or sustained fleet, reach out and we’ll provision for it.

Get Started

Guides

Migrations

Templates

Model integrations

Instance types

Available instances

Usage

Accepted values

RAM

CPU

OS

Resolution

Persistence

Included with every instance

RAM and vCPU on your plan

Scaling and limits

​Available instances

​Usage

​Accepted values

​RAM

​CPU

​OS

​Resolution

​Persistence

​Included with every instance

​RAM and vCPU on your plan

​Scaling and limits

Available instances

Usage

Accepted values

RAM

CPU

OS

Resolution

Persistence

Included with every instance

RAM and vCPU on your plan

Scaling and limits