mirror of
https://github.com/OpenRouterTeam/spawn.git
synced 2026-04-30 12:59:32 +00:00
c3e83ea00a
Cline is an open-source AI coding agent for the terminal. Works with OpenRouter via OPENAI_BASE_URL override. - Implemented on all 7 clouds - Matrix now 10 agents x 7 clouds = 70/70 implemented Co-authored-by: Sprite <noreply@sprite.dev> Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
586 lines
12 KiB
Markdown
586 lines
12 KiB
Markdown
# Spawn
|
|
|
|
Conjure your agents!
|
|
|
|
## Features
|
|
|
|
- 🔐 **Automatic OAuth** - Seamless authentication with OpenRouter
|
|
- 🔄 **Smart Fallback** - Manual API key entry if OAuth fails
|
|
- 🚀 **One Command Setup** - Get running in minutes
|
|
- 🔧 **Environment Ready** - Pre-configured shell and dependencies
|
|
|
|
## Usage
|
|
|
|
#### Claude Code
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/sprite/claude.sh)
|
|
```
|
|
|
|
#### OpenClaw
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/sprite/openclaw.sh)
|
|
```
|
|
|
|
#### NanoClaw
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/sprite/nanoclaw.sh)
|
|
```
|
|
|
|
#### Aider
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/sprite/aider.sh)
|
|
```
|
|
|
|
#### Goose
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/sprite/goose.sh)
|
|
```
|
|
|
|
#### Codex CLI
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/sprite/codex.sh)
|
|
```
|
|
|
|
#### Open Interpreter
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/sprite/interpreter.sh)
|
|
```
|
|
|
|
#### Gemini CLI
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/sprite/gemini.sh)
|
|
```
|
|
### Non-Interactive Mode
|
|
|
|
#### Amazon Q CLI
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/sprite/amazonq.sh)
|
|
```
|
|
For automation or CI/CD, set environment variables:
|
|
|
|
#### Cline
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/sprite/cline.sh)
|
|
```
|
|
#### Claude Code
|
|
|
|
```bash
|
|
SPRITE_NAME=dev-mk1 \
|
|
OPENROUTER_API_KEY=sk-or-v1-xxxxx \
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/sprite/claude.sh)
|
|
```
|
|
|
|
#### OpenClaw
|
|
|
|
```bash
|
|
SPRITE_NAME=dev-mk1 \
|
|
OPENROUTER_API_KEY=sk-or-v1-xxxxx \
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/sprite/openclaw.sh)
|
|
```
|
|
|
|
#### NanoClaw
|
|
|
|
```bash
|
|
SPRITE_NAME=dev-mk1 \
|
|
OPENROUTER_API_KEY=sk-or-v1-xxxxx \
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/sprite/nanoclaw.sh)
|
|
```
|
|
|
|
**Environment Variables:**
|
|
- `SPRITE_NAME` - Name for the sprite (skips prompt)
|
|
- `OPENROUTER_API_KEY` - Skip OAuth and use this API key directly
|
|
|
|
---
|
|
|
|
## Hetzner Cloud
|
|
|
|
Spawn agents on [Hetzner Cloud](https://www.hetzner.com/cloud/) servers. No `hcloud` CLI needed — uses the Hetzner REST API directly.
|
|
|
|
### Usage
|
|
|
|
#### Claude Code
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/hetzner/claude.sh)
|
|
```
|
|
|
|
#### OpenClaw
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/hetzner/openclaw.sh)
|
|
```
|
|
|
|
#### NanoClaw
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/hetzner/nanoclaw.sh)
|
|
```
|
|
|
|
#### Aider
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/hetzner/aider.sh)
|
|
```
|
|
|
|
#### Goose
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/hetzner/goose.sh)
|
|
```
|
|
|
|
#### Codex CLI
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/hetzner/codex.sh)
|
|
```
|
|
|
|
#### Open Interpreter
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/hetzner/interpreter.sh)
|
|
```
|
|
|
|
#### Gemini CLI
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/hetzner/gemini.sh)
|
|
```
|
|
### Non-Interactive Mode
|
|
|
|
#### Amazon Q CLI
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/hetzner/amazonq.sh)
|
|
```
|
|
```bash
|
|
HETZNER_SERVER_NAME=dev-mk1 \
|
|
HCLOUD_TOKEN=your-hetzner-api-token \
|
|
OPENROUTER_API_KEY=sk-or-v1-xxxxx \
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/hetzner/claude.sh)
|
|
```
|
|
|
|
#### Cline
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/hetzner/cline.sh)
|
|
```
|
|
**Environment Variables:**
|
|
- `HETZNER_SERVER_NAME` - Name for the server (skips prompt)
|
|
- `HCLOUD_TOKEN` - Hetzner Cloud API token (skips prompt, saved to `~/.config/spawn/hetzner.json`)
|
|
- `OPENROUTER_API_KEY` - Skip OAuth and use this API key directly
|
|
- `HETZNER_SERVER_TYPE` - Server type (default: `cx22`)
|
|
- `HETZNER_LOCATION` - Datacenter location (default: `fsn1`)
|
|
|
|
---
|
|
|
|
## DigitalOcean
|
|
|
|
Spawn agents on [DigitalOcean](https://www.digitalocean.com/) Droplets via REST API.
|
|
|
|
### Usage
|
|
|
|
#### Claude Code
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/digitalocean/claude.sh)
|
|
```
|
|
|
|
#### OpenClaw
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/digitalocean/openclaw.sh)
|
|
```
|
|
|
|
#### NanoClaw
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/digitalocean/nanoclaw.sh)
|
|
```
|
|
|
|
#### Aider
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/digitalocean/aider.sh)
|
|
```
|
|
|
|
#### Goose
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/digitalocean/goose.sh)
|
|
```
|
|
|
|
#### Codex CLI
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/digitalocean/codex.sh)
|
|
```
|
|
|
|
#### Open Interpreter
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/digitalocean/interpreter.sh)
|
|
```
|
|
|
|
#### Gemini CLI
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/digitalocean/gemini.sh)
|
|
```
|
|
### Non-Interactive Mode
|
|
|
|
#### Amazon Q CLI
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/digitalocean/amazonq.sh)
|
|
```
|
|
```bash
|
|
DO_DROPLET_NAME=dev-mk1 \
|
|
DO_API_TOKEN=your-digitalocean-api-token \
|
|
OPENROUTER_API_KEY=sk-or-v1-xxxxx \
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/digitalocean/claude.sh)
|
|
```
|
|
|
|
#### Cline
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/digitalocean/cline.sh)
|
|
```
|
|
**Environment Variables:**
|
|
- `DO_DROPLET_NAME` - Name for the droplet (skips prompt)
|
|
- `DO_API_TOKEN` - DigitalOcean API token (skips prompt, saved to `~/.config/spawn/digitalocean.json`)
|
|
- `OPENROUTER_API_KEY` - Skip OAuth and use this API key directly
|
|
- `DO_DROPLET_SIZE` - Droplet size (default: `s-2vcpu-2gb`)
|
|
- `DO_REGION` - Datacenter region (default: `nyc3`)
|
|
|
|
---
|
|
|
|
## Vultr
|
|
|
|
Spawn agents on [Vultr](https://www.vultr.com/) Cloud Compute instances via REST API.
|
|
|
|
### Usage
|
|
|
|
#### Claude Code
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/vultr/claude.sh)
|
|
```
|
|
|
|
#### OpenClaw
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/vultr/openclaw.sh)
|
|
```
|
|
|
|
#### NanoClaw
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/vultr/nanoclaw.sh)
|
|
```
|
|
|
|
#### Aider
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/vultr/aider.sh)
|
|
```
|
|
|
|
#### Goose
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/vultr/goose.sh)
|
|
```
|
|
|
|
#### Codex CLI
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/vultr/codex.sh)
|
|
```
|
|
|
|
#### Open Interpreter
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/vultr/interpreter.sh)
|
|
```
|
|
|
|
#### Gemini CLI
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/vultr/gemini.sh)
|
|
```
|
|
### Non-Interactive Mode
|
|
|
|
#### Amazon Q CLI
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/vultr/amazonq.sh)
|
|
```
|
|
```bash
|
|
VULTR_SERVER_NAME=dev-mk1 \
|
|
VULTR_API_KEY=your-vultr-api-key \
|
|
OPENROUTER_API_KEY=sk-or-v1-xxxxx \
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/vultr/claude.sh)
|
|
```
|
|
|
|
#### Cline
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/vultr/cline.sh)
|
|
```
|
|
**Environment Variables:**
|
|
- `VULTR_SERVER_NAME` - Name for the instance (skips prompt)
|
|
- `VULTR_API_KEY` - Vultr API key (skips prompt, saved to `~/.config/spawn/vultr.json`)
|
|
- `OPENROUTER_API_KEY` - Skip OAuth and use this API key directly
|
|
- `VULTR_PLAN` - Instance plan (default: `vc2-1c-2gb`)
|
|
- `VULTR_REGION` - Datacenter region (default: `ewr`)
|
|
|
|
---
|
|
|
|
## Linode (Akamai)
|
|
|
|
Spawn agents on [Linode](https://www.linode.com/) instances via REST API.
|
|
|
|
### Usage
|
|
|
|
#### Claude Code
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/linode/claude.sh)
|
|
```
|
|
|
|
#### OpenClaw
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/linode/openclaw.sh)
|
|
```
|
|
|
|
#### NanoClaw
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/linode/nanoclaw.sh)
|
|
```
|
|
|
|
#### Aider
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/linode/aider.sh)
|
|
```
|
|
|
|
#### Goose
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/linode/goose.sh)
|
|
```
|
|
|
|
#### Codex CLI
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/linode/codex.sh)
|
|
```
|
|
|
|
#### Open Interpreter
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/linode/interpreter.sh)
|
|
```
|
|
|
|
#### Gemini CLI
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/linode/gemini.sh)
|
|
```
|
|
### Non-Interactive Mode
|
|
|
|
#### Amazon Q CLI
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/linode/amazonq.sh)
|
|
```
|
|
```bash
|
|
LINODE_SERVER_NAME=dev-mk1 \
|
|
LINODE_API_TOKEN=your-linode-api-token \
|
|
OPENROUTER_API_KEY=sk-or-v1-xxxxx \
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/linode/claude.sh)
|
|
```
|
|
|
|
#### Cline
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/linode/cline.sh)
|
|
```
|
|
**Environment Variables:**
|
|
- `LINODE_SERVER_NAME` - Label for the Linode (skips prompt)
|
|
- `LINODE_API_TOKEN` - Linode API token (skips prompt, saved to `~/.config/spawn/linode.json`)
|
|
- `OPENROUTER_API_KEY` - Skip OAuth and use this API key directly
|
|
- `LINODE_TYPE` - Instance type (default: `g6-standard-1`)
|
|
- `LINODE_REGION` - Datacenter region (default: `us-east`)
|
|
|
|
---
|
|
|
|
## AWS Lightsail
|
|
|
|
Spawn agents on [AWS Lightsail](https://aws.amazon.com/lightsail/) instances. Requires AWS CLI installed and configured (`aws configure`).
|
|
|
|
### Usage
|
|
|
|
#### Claude Code
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/aws-lightsail/claude.sh)
|
|
```
|
|
|
|
#### OpenClaw
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/aws-lightsail/openclaw.sh)
|
|
```
|
|
|
|
#### NanoClaw
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/aws-lightsail/nanoclaw.sh)
|
|
```
|
|
|
|
#### Aider
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/aws-lightsail/aider.sh)
|
|
```
|
|
|
|
#### Goose
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/aws-lightsail/goose.sh)
|
|
```
|
|
|
|
#### Codex CLI
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/aws-lightsail/codex.sh)
|
|
```
|
|
|
|
#### Open Interpreter
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/aws-lightsail/interpreter.sh)
|
|
```
|
|
|
|
#### Gemini CLI
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/aws-lightsail/gemini.sh)
|
|
```
|
|
### Non-Interactive Mode
|
|
|
|
#### Amazon Q CLI
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/aws-lightsail/amazonq.sh)
|
|
```
|
|
```bash
|
|
LIGHTSAIL_SERVER_NAME=dev-mk1 \
|
|
OPENROUTER_API_KEY=sk-or-v1-xxxxx \
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/aws-lightsail/claude.sh)
|
|
```
|
|
|
|
#### Cline
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/aws-lightsail/cline.sh)
|
|
```
|
|
**Environment Variables:**
|
|
- `LIGHTSAIL_SERVER_NAME` - Name for the instance (skips prompt)
|
|
- `OPENROUTER_API_KEY` - Skip OAuth and use this API key directly
|
|
- `LIGHTSAIL_BUNDLE` - Instance bundle (default: `medium_3_0`)
|
|
- `LIGHTSAIL_REGION` - AWS region (default: `us-east-1`)
|
|
|
|
---
|
|
|
|
## Lambda Cloud
|
|
|
|
Spawn agents on [Lambda Cloud](https://lambdalabs.com/) GPU instances via REST API. Great for GPU-accelerated AI workloads.
|
|
|
|
### Usage
|
|
|
|
#### Claude Code
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/lambda/claude.sh)
|
|
```
|
|
|
|
#### OpenClaw
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/lambda/openclaw.sh)
|
|
```
|
|
|
|
#### NanoClaw
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/lambda/nanoclaw.sh)
|
|
```
|
|
|
|
#### Aider
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/lambda/aider.sh)
|
|
```
|
|
|
|
#### Goose
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/lambda/goose.sh)
|
|
```
|
|
|
|
#### Codex CLI
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/lambda/codex.sh)
|
|
```
|
|
|
|
#### Open Interpreter
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/lambda/interpreter.sh)
|
|
```
|
|
|
|
#### Gemini CLI
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/lambda/gemini.sh)
|
|
```
|
|
|
|
#### Amazon Q CLI
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/lambda/amazonq.sh)
|
|
```
|
|
### Non-Interactive Mode
|
|
|
|
#### Cline
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/lambda/cline.sh)
|
|
```
|
|
```bash
|
|
LAMBDA_SERVER_NAME=dev-mk1 \
|
|
LAMBDA_API_KEY=your-lambda-api-key \
|
|
OPENROUTER_API_KEY=sk-or-v1-xxxxx \
|
|
bash <(curl -fsSL https://openrouter.ai/lab/spawn/lambda/claude.sh)
|
|
```
|
|
|
|
**Environment Variables:**
|
|
- `LAMBDA_SERVER_NAME` - Name for the instance (skips prompt)
|
|
- `LAMBDA_API_KEY` - Lambda API key (skips prompt, saved to `~/.config/spawn/lambda.json`)
|
|
- `OPENROUTER_API_KEY` - Skip OAuth and use this API key directly
|
|
- `LAMBDA_INSTANCE_TYPE` - Instance type (default: `gpu_1x_a10`)
|
|
- `LAMBDA_REGION` - Region (default: `us-east-1`)
|