# Tarout for AI Agents

> A guide for coding agents to help users build and deploy applications on the Saudi cloud

# Tarout for AI Agents

Tarout is the Saudi cloud platform built for coding agents. It lets coding agents both **write application code** and **define the infrastructure** to deploy and run it - all through the Tarout CLI and dashboard.

## What Tarout provides

| Primitive | Description |
|-----------|-------------|
| **Applications** | Deploy any language or framework. Auto-detected, no Dockerfiles required. |
| **Databases** | Managed PostgreSQL 16 with connection pooling. Scheduled backups go to the user's own S3-compatible bucket. |
| **Object Storage** | S3-compatible storage. Upload and retrieve files with zero configuration. |
| **AI Gateway** | One OpenAI-compatible API key for every model in the catalog: five open-weight flagships on Global plus fast inference on the Saudi Arabia route, billed per token in SAR. |
| **GPU Servers** | Coming soon: NVIDIA GPU VMs for ML training and inference. Not available to rent yet. |
| **Custom Domains** | Automatic SSL via Let's Encrypt. Apex, subdomain, and wildcard support. |
| **Developer Tools** | CLI, GitHub/GitLab CI/CD, real-time logs, environment variables. |

All infrastructure runs in **Dammam, Saudi Arabia (GCP me-central2)** - full data residency within the Kingdom.

## No SDK required

Tarout works with **any programming language and any framework**. There is no SDK to install and no framework lock-in. Your coding agent configures and deploys whatever stack is already being used.

## Quick reference

```sh
# Install Tarout CLI
npm install -g @tarout/cli

# Always check auth first - this is the cheapest command in the CLI and it
# separates "not signed in" from every other failure.
tarout whoami --json

# Only if that fails. Credentials are per project - this writes ./.tarout/auth.json
# in the current directory and every later command reuses it.
tarout login --token <YOUR_API_KEY>          # prompt ended with "Key: ..."
tarout agent connect --handoff <HANDOFF>     # prompt ended with "Handoff: t2..."
tarout login                                 # neither - opens the browser

# Step 1 - grant the agent permission to run tarout commands.
# Writes CLAUDE.md + allowlists Bash(tarout:*) so later commands need no approval.
tarout agent init --agent claude

# The agent inspects the project, announces the plan, then deploys immediately.
# Simple default: deploy on your org's subscribed tier (no database, no storage).
# A folder on GitHub deploys from its repo so every push redeploys; any other
# folder is uploaded. Don't pass --plan free, and don't pass --source upload.
tarout deploy --wait --database none

# If the result says data.source.pushToDeploy is false, run data.source.next:
tarout providers github connect --wait --app <app-id>

# Check deployment status
tarout deploy:status <app-id>

# Stream logs
tarout deploy:logs <deployment-id> --follow
```

## Next steps

**Agents: [Start Here](https://tarout.sa/docs/for-ai/start) is the only page you need to read
first.** It routes to one guide per task:

- [Start Here](https://tarout.sa/docs/for-ai/start) - hard rules, install, authenticate, deploy.
- [Deploying an app](https://tarout.sa/docs/for-ai/deploy) - sources, inspection, env vars, running locally.
- [Databases](https://tarout.sa/docs/for-ai/database) - managed PostgreSQL.
- [Object storage](https://tarout.sa/docs/for-ai/storage) - S3-compatible buckets.
- [Custom domains](https://tarout.sa/docs/for-ai/domains) - the one supported DNS flow.
- [Plans and upgrades](https://tarout.sa/docs/for-ai/billing) - checkout, add-ons, `NEEDS_UPGRADE`.
- [Troubleshooting](https://tarout.sa/docs/for-ai/troubleshoot) - failure-mode policy and error codes.
- [CLI Reference](https://tarout.sa/docs/for-ai/cli-reference) - all CLI commands your agent needs.
- [Getting Started](https://tarout.sa/docs/getting-started) - general platform introduction.

---

## Every Tarout agent guide

- [Start Here (Agents)](https://tarout.sa/docs/for-ai/start.md)
- [Deploying an app](https://tarout.sa/docs/for-ai/deploy.md)
- [Databases](https://tarout.sa/docs/for-ai/database.md)
- [Object storage](https://tarout.sa/docs/for-ai/storage.md)
- [Custom domains](https://tarout.sa/docs/for-ai/domains.md)
- [Plans and upgrades](https://tarout.sa/docs/for-ai/billing.md)
- [Troubleshooting](https://tarout.sa/docs/for-ai/troubleshoot.md)
- [Agent Onboarding](https://tarout.sa/docs/for-ai/onboarding.md)
- [CLI Reference](https://tarout.sa/docs/for-ai/cli-reference.md)
- [CLI JSON Schema](https://tarout.sa/docs/for-ai/cli-json-schema.md)

Whole corpus in one file: https://tarout.sa/llms-full.txt · index: https://tarout.sa/llms.txt
Any docs page is raw markdown at the same URL + `.md`. Short link to the entry point: https://tarout.sa/deploy.md