{"id":51040060,"url":"https://github.com/runtm-ai/runtm","last_synced_at":"2026-07-10T11:00:50.094Z","repository":{"id":331513124,"uuid":"1126944529","full_name":"runtm-ai/runtm","owner":"runtm-ai","description":"Open-source sandboxes where coding agents build and deploy. Spin up isolated environments where Claude Code, Cursor, and other agents code and deploy software.","archived":false,"fork":false,"pushed_at":"2026-07-09T23:37:07.000Z","size":7480,"stargazers_count":282,"open_issues_count":20,"forks_count":31,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-07-10T01:11:28.744Z","etag":null,"topics":["agent-runtime","agentic","ai-agents","anthropic","app-runtime","claude","claude-code","control-plane","cursor","ephemeral-environments","infra","llm-tools","llmops","observability","open-source","openai","sandbox","serverless"],"latest_commit_sha":null,"homepage":"https://www.runtm.com/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/runtm-ai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-02T21:37:04.000Z","updated_at":"2026-07-09T23:37:10.000Z","dependencies_parsed_at":"2026-02-16T00:03:00.160Z","dependency_job_id":null,"html_url":"https://github.com/runtm-ai/runtm","commit_stats":null,"previous_names":["runtm-ai/runtm"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/runtm-ai/runtm","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runtm-ai%2Fruntm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runtm-ai%2Fruntm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runtm-ai%2Fruntm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runtm-ai%2Fruntm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/runtm-ai","download_url":"https://codeload.github.com/runtm-ai/runtm/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runtm-ai%2Fruntm/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35329609,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-10T02:00:06.465Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-runtime","agentic","ai-agents","anthropic","app-runtime","claude","claude-code","control-plane","cursor","ephemeral-environments","infra","llm-tools","llmops","observability","open-source","openai","sandbox","serverless"],"created_at":"2026-06-22T10:00:28.885Z","updated_at":"2026-07-10T11:00:50.088Z","avatar_url":"https://github.com/runtm-ai.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Runtm\n\n[![License: AGPL v3](https://img.shields.io/badge/Server-AGPLv3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)\n[![License: Apache 2.0](https://img.shields.io/badge/CLI-Apache%202.0-green.svg)](https://opensource.org/licenses/Apache-2.0)\n[![License: MIT](https://img.shields.io/badge/Templates-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Discord](https://img.shields.io/discord/1342243238748225556?logo=discord\u0026logoColor=white\u0026color=7289DA)](https://discord.com/invite/JUuCkUKc)\n\nOpen-source sandboxes where coding agents build and deploy.\n\nSpin up isolated environments where Claude Code, Cursor, Codex, and other agents code and ship software. With live URLs, logs, and previews.\n\n**[Website](https://runtm.com)** · **[Docs](https://docs.runtm.com)** · **[Get Started](https://app.runtm.com)**\n\n## Demo\n\nhttps://github.com/user-attachments/assets/8d6d5ab8-a5c4-4a3d-8ef1-5d20b67ed3ee\n\n## Why Runtm?\n\n- **Sandboxes for yolo agents** – Let agents code with full permissions in isolated environments. No risk to your machine or cloud.\n- **Run any coding agent** – Claude Code, Cursor, Codex, Gemini CLI, and more. Bring your favorite.\n- **Real URLs instantly** – Agents deploy to live HTTPS endpoints. Test, share, and iterate.\n- **Logs and observability** – See what your agent built, debug issues, fix and redeploy.\n\n## Quick Start\n\n```bash\n# Install\nuv tool install runtm\n\n# Start a local sandbox session\nruntm session start\n\n# Your agent builds inside the sandbox...\n\n# Deploy to a live URL\nruntm session deploy\n```\n\nYou get a live HTTPS endpoint on auto-stopping infrastructure. Machines spin down when idle and wake up on traffic.\n\n## Local Sandbox Sessions\n\nRun AI agents in isolated local environments with OS-level sandboxing:\n\n```bash\n# Start a sandbox (auto-installs deps on first run)\nruntm session start\n\n# Start with a template\nruntm session start --template web-app\n\n# Use a different agent\nruntm session start --agent codex\n\n# List all sandboxes\nruntm session list\n\n# Reattach to a sandbox\nruntm session attach sbx_abc123\n\n# Deploy from sandbox to live URL\nruntm session deploy\n```\n\n**What you get:**\n- **OS-level isolation** – Uses bubblewrap (Linux) or seatbelt (macOS) for fast, secure sandboxing\n- **Instant startup** – Sandboxes start in \u003c100ms, no containers needed\n- **Multi-agent support** – Works with Claude Code, Codex, Gemini CLI, and more\n- **Persistent workspaces** – Stop and resume sessions, files preserved\n\n## How It Works\n\n```\n┌────────────┐     ┌─────────┐     ┌─────────┐     ┌──────────┐\n│ Your Agent │ ──▶ │ Sandbox │ ──▶ │  Runtm  │ ──▶ │ Live URL │\n└────────────┘     └─────────┘     └─────────┘     └──────────┘\n```\n\n1. **Spin up a sandbox** – Your agent gets an isolated workspace\n2. **Agent builds** – Full permissions to code, install deps, run tests\n3. **Deploy** – One command to a real URL with logs and previews\n4. **Iterate** – Agent can see logs, fix bugs, and redeploy\n\n## Installation\n\nThe pip CLI (`runtm`) for local sandboxes, scaffolding, and deploys:\n\n```bash\n# Recommended\nuv tool install runtm\n\n# Alternative\npipx install runtm\n\n# Or with pip\npip install runtm\n```\n\nThe Go CLI (`runtm-api`) is a separate, lighter tool for AI coding agents driving the hosted Cloud API:\n\n```bash\ncurl -fsSL https://runtm.com/install | bash\n```\n\nIt is JSON-in / JSON-out, has stable exit codes, and ships with embedded skill files for Claude Code, Cursor, and Codex. See [Agent CLI docs](https://docs.runtm.com/cloud-api/agent-cli) and the [`packages/agent/`](packages/agent/) source for details. The pip and Go CLIs share the same API key.\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `runtm session start` | Start a new sandbox session |\n| `runtm session list` | List all sandboxes |\n| `runtm session attach \u003cid\u003e` | Reattach to a sandbox |\n| `runtm session stop \u003cid\u003e` | Stop a sandbox (preserves files) |\n| `runtm session destroy \u003cid\u003e` | Destroy sandbox and delete files |\n| `runtm session deploy` | Deploy from sandbox to live URL |\n| `runtm init` | Initialize a new project |\n| `runtm deploy` | Deploy to a live URL |\n| `runtm logs \u003cid\u003e` | View build, deploy, and runtime logs |\n| `runtm status \u003cid\u003e` | Check deployment status |\n| `runtm destroy \u003cid\u003e` | Tear down a deployment |\n\nSee the [CLI docs](https://docs.runtm.com/cli/overview) for the full reference.\n\n## Self-Hosting\n\nRuntm can be fully self-hosted. See the [self-hosting guide](https://docs.runtm.com/self-hosting/overview).\n\n```bash\ngit clone https://github.com/runtm-ai/runtm.git\ncd runtm\ncp infra/local.env.example .env\n\n# Install packages (includes sandbox and agents)\n./scripts/dev.sh setup\n\n# Start local services\ndocker compose -f infra/docker-compose.yml up -d\n\n# Use the development CLI\nruntm-dev start                    # Start a sandbox session\nruntm-dev prompt \"Build an API\"    # Send prompt to agent\n```\n\n**Note:** Use `runtm-dev` (not `runtm`) when self-hosting. The dev CLI includes sandbox/agents packages.\n\n## Project Structure\n\n```\npackages/\n  shared/     # Types, manifest schema, errors\n  sandbox/    # Local sandbox runtime (OS-level isolation)\n  agents/     # AI coding agent adapters (Claude Code, Codex, etc.)\n  api/        # FastAPI control plane\n  worker/     # Build + deploy pipeline\n  cli/        # Python CLI (Typer) - `runtm` (local sandbox + deploy)\n  agent/      # Go CLI (Cobra) - `runtm-api` (hosted Cloud API for AI agents)\n\ntemplates/    # Starter projects (backend, static, fullstack)\n```\n\n## Documentation\n\nFull docs at [docs.runtm.com](https://docs.runtm.com):\n\n- [Quickstart](https://docs.runtm.com/quickstart)\n- [CLI Reference](https://docs.runtm.com/cli/overview)\n- [API Reference](https://docs.runtm.com/api/overview)\n- [Self-Hosting](https://docs.runtm.com/self-hosting/overview)\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.\n\n## License\n\n| Component | License |\n|-----------|---------|\n| Server (api, worker, infra) | [AGPLv3](packages/api/LICENSE) |\n| CLI, Sandbox, Shared | [Apache-2.0](packages/cli/LICENSE) |\n| Templates | [MIT](templates/LICENSE) |\n\n## Support\n\n[Open an issue](https://github.com/runtm-ai/runtm/issues) or join our [Discord](https://discord.com/invite/JUuCkUKc).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fruntm-ai%2Fruntm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fruntm-ai%2Fruntm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fruntm-ai%2Fruntm/lists"}