> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orgo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Instance Types

> Compute configurations for Orgo cloud computers

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 the dashboard offers and [Orgo's price list](https://www.orgo.ai/pricing.md) prices.

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

Omit `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](#accepted-values).

A Linux computer boots at 1280x720 unless you pass `resolution`. Linux is the default operating system. Set `os` on [create](/api-reference/computers/create) to choose another.

***

## Usage

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

<CodeGroup>
  ```bash cURL theme={null}
  # 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": 1, "ram": 8, "disk_size_gb": 40}'
  ```

  ```python Python theme={null}
  from orgo import Computer

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

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

  # XL
  computer = Computer(ram=32, cpu=2)
  ```

  ```typescript TypeScript theme={null}
  import { Computer } from 'orgo';

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

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

  // XL
  const xl = await Computer.create({ ram: 32, cpu: 2 });
  ```
</CodeGroup>

<Note>
  The SDKs take a `cpu` of 0.5, 1, 2, 4, 8, or 16 and 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](/guides/cli).
</Note>

***

## 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, 8, or 16 cores"}`. Omit any of the three and you get the default.

Clearing that check is not the whole story. **One computer is capped at 4 vCPU, 64 GB RAM, and 300 GB of disk.** No plan on sale raises that cap, and add-ons only take you up to it. Your plan's per-computer ceiling is at or below the cap. See [Orgo pricing](https://www.orgo.ai/#pricing).

### RAM

Integer, optional, in GB. Defaults to `4`.

| Value | Description |
| - | - |
| `4` | 4GB (default) |
| `8` | 8GB |
| `16` | 16GB |
| `32` | 32GB |
| `64` | 64GB (the per-computer cap) |

Anything else returns `400`: `{"error": "ram must be 4, 8, 16, 32, or 64 GB"}`.

A macOS computer also accepts `12`. For `os: "macos"` the error lists that value too: `{"error": "ram must be 4, 8, 12, 16, 32, or 64 GB"}`.

<Note>
  Your plan also caps RAM per computer, below the 64 GB cap, and RAM across your account. A request inside the table above can still be refused with `403` on quota grounds. See [Orgo pricing](https://www.orgo.ai/#pricing) for the current limits.
</Note>

### CPU

Number, optional, in cores. Defaults to `1`.

| Value | Description |
| - | - |
| `0.5` | Half a core |
| `1` | 1 core (default) |
| `2` | 2 cores |
| `4` | 4 cores (the per-computer cap) |
| `8` | Accepted by the value check, then refused with `403` |
| `16` | Accepted by the value check, then refused with `403` |

Anything else returns `400`: `{"error": "cpu must be 0.5, 1, 2, 4, 8, or 16 cores"}`.

`8` and `16` are in the accepted set, so they clear the value check. They then fail the quota check with `403` and code `PER_COMPUTER_CPU_CAP`, on every plan on sale. Treat `4` as the real maximum.

### 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.

```text theme={null}
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 trial computer stops after 30 minutes.

***

## 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

## Plans

Instance type sets the resources of one computer. How many computers you can run, how much RAM and storage they draw from in total, and how many seats your team gets are all properties of your plan.

Plans change, so this page does not restate them. See [Orgo pricing](https://www.orgo.ai/#pricing) for current limits and pricing.

## Scaling and limits

Your **Usage** page (the gauge button at the bottom of the sidebar, or `https://www.orgo.ai/account?tab=usage`) shows what you have in use against your limits and lets you add computers, RAM, vCPU, and storage to your account.

If you're planning a large or sustained fleet, [reach out](mailto:spencer@orgo.ai) and we'll provision for it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.