spawn/render/README.md
A f421b76f5f
feat: Add render/goose.sh (#245)
Implements Goose agent on Render with:
- Direct install via Block's download_cli.sh script
- Native OpenRouter support via GOOSE_PROVIDER env var
- Simple environment configuration
- Interactive session launch

Agent: gap-filler

Co-authored-by: B <6723574+louisgv@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-10 12:55:16 -08:00

3.6 KiB

Render

Render is a modern cloud platform for deploying full-stack applications, APIs, and websites. It offers a developer-first experience with automatic deployments, built-in SSL, and managed infrastructure.

Features

  • Free Hobby Plan: Free tier for development and small projects
  • Docker Support: Native Docker container support
  • CLI & SSH Access: Full CLI tooling with SSH access via render ssh
  • REST API: Comprehensive API for programmatic provisioning
  • Auto Deployments: Automatic deployments from Git repositories
  • Managed Services: PostgreSQL, Redis, and other managed services

Authentication

Render scripts require a RENDER_API_KEY. Get yours at: https://dashboard.render.com/u/settings/api-keys

The scripts will:

  1. Check for RENDER_API_KEY environment variable
  2. Fall back to saved key at ~/.config/spawn/render.json
  3. Prompt for the key if neither is available

Available Agents

Claude Code

bash <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/render/claude.sh)

Deploys Claude Code with OpenRouter integration. Configures:

  • Automatic OpenRouter API base URL
  • Bypass permissions mode for autonomous operation
  • Dark theme and vim editor settings

OpenClaw

bash <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/render/openclaw.sh)

Deploys OpenClaw with multi-channel gateway and TUI. Starts gateway in background, then launches interactive TUI. Prompts for model selection (default: openrouter/auto).

NanoClaw

bash <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/render/nanoclaw.sh)

Deploys NanoClaw WhatsApp-based AI agent. Requires WhatsApp QR code scan for authentication.

Aider

bash <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/render/aider.sh)

Deploys Aider with OpenRouter model routing. Prompts for model selection (default: openrouter/auto).

Goose

bash <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/render/goose.sh)

Deploys Goose AI coding agent by Block with native OpenRouter support.

Codex CLI

bash <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/render/codex.sh)

Deploys Codex CLI with OpenRouter integration via OPENAI_BASE_URL override.

Open Interpreter

bash <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/render/interpreter.sh)

Deploys Open Interpreter with OpenRouter integration via OPENAI_BASE_URL override.

Gemini CLI

bash <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/render/gemini.sh)

Deploys Gemini CLI with OpenRouter integration via OPENAI_BASE_URL and GEMINI_API_KEY override.

Service Details

  • Plan: Starter (can be configured)
  • Region: Oregon (default)
  • Runtime: Docker
  • Base Image: render-examples/docker-hello-world (minimal Ubuntu with SSH)

Environment Variables

All scripts support:

  • RENDER_API_KEY: Your Render API token
  • OPENROUTER_API_KEY: Your OpenRouter API key (or OAuth flow)

Cleanup

Services are automatically cleaned up on exit. Manual cleanup:

render services:delete <service-id>

Limitations

  • Render's free Hobby plan has resource limits (512MB RAM, 0.1 CPU)
  • Services spin down after 15 minutes of inactivity
  • Cold starts take 30-60 seconds