CreateOS Sandbox examples
Show me it running my use case. Every example below is a complete, runnable program in the SDK repo: spin up a Firecracker micro-VM, do the thing, tear it down. Run untrusted code, fork agent state for parallel rollouts, network sandboxes together, fan out across many, or self-host the whole worker.
Start here
The demos that show what only CreateOS Sandbox does: isolation, networking, fork, fan-out, and self-host.
- AI code agentUse a sandbox as the code-execution environment for a Claude agent.createSandboxfiles.uploadrunCommanddestroyView on GitHub
- Filesystem snapshotsSnapshot/branch a sandbox: pause, fork, resume the clone.files.uploadrunCommandpauseforkView on GitHub
- Radicle multi-agentThree networked sandboxes running a Radicle p2p git mesh with role-specialized agents.createSandboxrunCommandfiles.downloadnetworks.createView on GitHub
- Analyze data with AIUpload a CSV, have Claude write the analysis from its schema, read back the chart.createSandboxfiles.uploadfiles.downloadrunCommandView on GitHub
- Batch inference fan-outShard a classification job across many sandboxes in parallel.createSandboxfiles.uploadrunCommandlistSandboxesView on GitHub
- Self-hosted agent workerBack a Claude Managed Agent with one persistent VM for tool execution.createSandboxrunCommandfiles.downloaddestroyView on GitHub
Core and lifecycle
Create, run, snapshot, pause, and fork: the primitives every workload is built on.
- Hello worldSmoke test: create a sandbox, run one buffered command, destroy it.createSandboxrunCommanddestroyView on GitHub
- Code interpreterUpload a Python script, run it, capture stdout/stderr. Includes a streaming variant.createSandboxfiles.uploadrunCommandstreamCommandView on GitHub
- Dev server preview URLBind an HTTP server and reach it via a per-sandbox ingress preview URL.createSandboxrunCommandwaitForPortReadypreviewUrlView on GitHub
- Filesystem snapshotsSnapshot/branch a sandbox: pause, fork, resume the clone.files.uploadrunCommandpauseforkView on GitHub
- All-in-one tourAll-in-one tour exercising every core primitive in one run.createSandboxfiles.uploadfiles.downloadrunCommandView on GitHub
- Bandwidth rechargeRead a sandbox's bandwidth quota and grow it after create with rechargeBandwidth (create no longer accepts bandwidth_quota_bytes).createSandboxgetBandwidthrechargeBandwidthdestroyView on GitHub
- Idle auto-pauseSet an idle auto-pause timeout at create with auto_pause_after_seconds and change it live with setAutoPause(seconds | null) so an idle sandbox stops vCPU billing.createSandboxsetAutoPausedestroyView on GitHub
AI agents and frameworks
Drive agents and agent frameworks whose code runs inside an isolated VM.
- AI code agentUse a sandbox as the code-execution environment for a Claude agent.createSandboxfiles.uploadrunCommanddestroyView on GitHub
- OpenAI Agents toolsExpose sandbox operations as tools to the OpenAI Agents SDK.createSandboxfiles.uploadrunCommanddestroyView on GitHub
- MCP: Claude CodeRun the Claude Code CLI inside a sandbox.createSandboxrunCommandstreamCommanddestroyView on GitHub
- LlamaIndex RAGBuild a LlamaIndex vector index; persist it across pause/resume.createSandboxfiles.uploadfiles.downloadrunCommandView on GitHub
- ACP hello worldRun an Agent Client Protocol agent in a sandbox over JSON-RPC.createSandboxfiles.uploadrunCommanddestroyView on GitHub
- Google ADK agentDrive a Google ADK agent whose tools run inside a VM.createSandboxrunCommanddestroyView on GitHub
- LangGraph orchestratorModel sandbox operations as LangGraph nodes with an OpenAI LLM.createSandboxfiles.uploadrunCommanddestroyView on GitHub
- OpenAI Codex CLIRun the OpenAI Codex CLI in a sandbox to execute a task.createSandboxfiles.uploadfiles.downloadrunCommandView on GitHub
- Claude changelog generatorClone a public git repo inside a sandbox, run the commit log through the Claude Messages API, and download the generated CHANGELOG.md.createSandboxshrunCommandfiles.uploadView on GitHub
- Claude agent GitHub wiki Q&AClone a public GitHub repo into a sandbox and run a Claude tool-use agent that reads the file tree to answer questions about the codebase.createSandboxrunCommanddestroyView on GitHub
- Mastra agent in a sandboxInstall the Mastra TypeScript agent framework inside a createos-sandbox VM, upload an agent script, run it against an OpenAI-compatible provider, and capture the response.createSandboxshfiles.uploaddestroyView on GitHub
- Effective agent patternsRun three LLM agent patterns (prompt-chaining, routing, parallelization) using the Vercel AI SDK inside a createos-sandbox sandbox, with an OpenAI-compatible model proxy.createSandboxfiles.uploadrunCommandshView on GitHub
Networking and scale
Multiple sandboxes on a private network, and fan-out across many at once.
- Radicle multi-agentThree networked sandboxes running a Radicle p2p git mesh with role-specialized agents.createSandboxrunCommandfiles.downloadnetworks.createView on GitHub
- Batch inference fan-outShard a classification job across many sandboxes in parallel.createSandboxfiles.uploadrunCommandlistSandboxesView on GitHub
Dev servers and environments
Long-lived services and dev environments reached over a per-sandbox ingress URL.
- Dev server + git previewClone a repo, start a dev server, expose it via a live ingress URL.createSandboxrunCommandwaitForPortReadypreviewUrlView on GitHub
- Jupyter singleton kernelKeep a persistent Python kernel over a socket; pause and fork two branches.createSandboxfiles.uploadrunCommandpauseView on GitHub
- Text embeddings serverServe a CPU embeddings model as a long-lived service over ingress.createSandboxfiles.uploadrunCommandwaitForPortReadyView on GitHub
- Astro in a sandboxScaffold an Astro site, run `astro dev`, reach it via ingress.createSandboxfiles.uploadrunCommandwaitForPortReadyView on GitHub
- OpenCode serverRun the OpenCode headless HTTP server over ingress.createSandboxfiles.uploadrunCommandwaitForPortReadyView on GitHub
- Prometheus PushgatewayRun a Prometheus Pushgateway, push a metric, scrape it via ingress.createSandboxrunCommandwaitForPortReadypreviewUrlView on GitHub
- FastAPI appServe a FastAPI app over ingress and verify its routes.createSandboxfiles.uploadrunCommandwaitForPortReadyView on GitHub
- code-server (VS Code)Run code-server (VS Code in the browser) over ingress.createSandboxrunCommandwaitForPortReadypreviewUrlView on GitHub
- Headless Chromium DevToolsRun headless Chrome with the CDP port exposed via ingress.createSandboxfiles.uploadrunCommandwaitForPortReadyView on GitHub
- OpenClaw gatewayRun the OpenClaw gateway over ingress and verify /v1/models.createSandboxrunCommandstreamCommandwaitForPortReadyView on GitHub
Browser and scraping
Headless browsers and crawlers running inside the isolation boundary.
- MCP: BrowserbaseRun the Browserbase MCP server in a sandbox, driven by Claude.createSandboxrunCommandwaitForPortReadypreviewUrlView on GitHub
- Firecrawl scrape + analyzeScrape pages with Firecrawl, have Claude write analysis code, run it, pull the chart.createSandboxfiles.uploadfiles.downloadrunCommandView on GitHub
- Playwright headless browserRun Playwright + headless Chromium to scrape and extract the DOM.createSandboxfiles.uploadrunCommanddestroyView on GitHub
- Crawl4AI web crawlerInstall Crawl4AI and Playwright/Chromium inside a VM, crawl a public URL to Markdown, download the output to the host.createSandboxfiles.uploadrunCommandfiles.downloadView on GitHub
Data, files, and storage
Bring your own storage, custom images, and file-in file-out data jobs.
- Docker custom templateBuild a custom rootfs template from a Dockerfile, then run containers inside the VM.templates.createtemplates.gettemplates.deletecreateSandboxView on GitHub
- TigerFS + PostgresRun PostgreSQL on a TigerFS filesystem layer in one VM.createSandboxfiles.uploadrunCommanddestroyView on GitHub
- Analyze data with AIUpload a CSV, have Claude write the analysis from its schema, read back the chart.createSandboxfiles.uploadfiles.downloadrunCommandView on GitHub
- S3 bucket queryQuery a public S3 bucket via DuckDB httpfs inside a sandbox.createSandboxfiles.uploadfiles.downloadrunCommandView on GitHub
- Git clone + TypeScript LSPClone a TS repo and drive typescript-language-server over stdio.createSandboxfiles.uploadrunCommanddestroyView on GitHub
- S3-disk ffmpeg transcodeRegister an S3-backed disk, mount at boot, transcode with ffmpeg, detach, destroy.disks.createdisks.getdisks.listdisks.deleteView on GitHub
- Python PDF form extractorUpload a fillable PDF into a sandbox, pip-install PyMuPDF, extract every form-field name and value to JSON, and download the result, no external API required.createSandboxfiles.uploadrunCommanddestroyView on GitHub
- Python doc to Markdown converterUpload a local document (HTML, DOCX, PDF, …) into a createos-sandbox sandbox, convert it to Markdown with Microsoft MarkItDown (pip-installed inside the guest), and download the result.createSandboxfiles.uploadrunCommandfiles.downloadView on GitHub
Self-host
Back agents with VMs you run in your own boundary.
Run your use case in an isolated micro-VM.
Deploy a sandbox with 500 free credits and run any example in minutes, or book a demo.