# Orgo

Cloud computers for AI agents. Each computer is a full Linux or Windows desktop that stays on 24/7. You can run commands, see the screen, click and type.

Send every API request with `Authorization: Bearer $ORGO_API_KEY`.

## 1. Get access

Connect over MCP at https://www.orgo.ai/mcp (your human approves in the browser, no key to copy), or get an API key with device approval:

```
POST https://www.orgo.ai/api/cli/auth/start   {"client": "<your name>", "hostname": "<host>"}
```

Show your human the `user_code` and `verification_uri`, then poll:

```
POST https://www.orgo.ai/api/cli/auth/poll    {"device_code": "<device_code>"}
```

The response contains your API key. Never print it. More: https://www.orgo.ai/auth.md

## 2. Choose a plan

Accounts are free. Launching a computer needs a paid plan: Starter $29/mo, Growth $99/mo, Scale $399/mo. Full details: https://www.orgo.ai/pricing.md

```
POST https://www.orgo.ai/api/checkout   {"plan": "hacker_v2"}
```

Plans: `hacker_v2` (Starter), `startup_v2` (Growth), `scale_v2` (Scale). The response has a Checkout `url`. Send it to your human to pay.

## 3. Launch a computer

```
GET  https://www.orgo.ai/api/workspaces
POST https://www.orgo.ai/api/computers   {"workspace_id": "<id>", "name": "my-computer", "os": "linux"}
```

To start from a template, add `"template_ref"`, for example `"system/hermes-agent@1.1.13"`. List templates: `GET https://www.orgo.ai/api/templates/global`. Browse agents: https://www.orgo.ai/explore

## 4. Use it

```
POST https://www.orgo.ai/api/computers/<id>/bash         {"command": "uname -a"}
GET  https://www.orgo.ai/api/computers/<id>/screenshot
POST https://www.orgo.ai/api/computers/<id>/click        {"x": 640, "y": 400}
POST https://www.orgo.ai/api/computers/<id>/type         {"text": "hello"}
```

## 5. Install software

```
POST https://www.orgo.ai/api/computers/<id>/bash   {"command": "sudo apt-get install -y ffmpeg"}
```

## Reference

- OpenAPI: https://www.orgo.ai/openapi.json
- Docs: https://docs.orgo.ai (llms.txt: https://docs.orgo.ai/llms.txt)
- Pricing: https://www.orgo.ai/pricing.md
- Auth: https://www.orgo.ai/auth.md