Bring Your Own Cloud
You provide your Hetzner or Scaleway API token. VMs run on your infrastructure, billed to your account. The platform never stores your cloud credentials as environment variables.
What is SAM?
Simple Agent Manager (SAM) is an open-source platform for running ephemeral AI coding agent environments. It provisions cloud VMs, sets up devcontainers, and gives you a browser-based interface with your choice of AI coding agent — Claude Code, OpenAI Codex, Google Gemini, or Mistral Vibe.
Why SAM?
Section titled “Why SAM?”AI coding agents need real development environments — not sandboxes. SAM gives each agent its own VM with a full Linux environment, Docker, and git, accessible through a web interface with chat and terminal.
Serverless Control Plane
The API runs on Cloudflare Workers — zero infrastructure to manage. D1 for storage, KV for sessions, R2 for binaries, Durable Objects for real-time chat.
Ephemeral by Design
Workspaces spin up in minutes and tear down when you’re done. Warm node pooling reuses idle VMs for fast follow-up work.
Self-Hostable
Fork the repo, configure a GitHub Environment, push to main. Automated deployment via Pulumi + GitHub Actions.
How It Works
Section titled “How It Works”- Sign in with GitHub via the web UI
- Add your cloud provider token in Settings (Hetzner or Scaleway)
- Configure agent credentials — add API keys for your preferred AI coding agents
- Install the GitHub App on your repositories
- Create a project — link a GitHub repo to start working
- Describe your idea — tell SAM what you want done; it provisions a VM, creates a workspace, and runs the agent autonomously
- Chat with agents — watch real-time streaming output, browse files, fork conversations, use voice input
- Review the PR — the agent commits, pushes, and opens a pull request when done
Key Features
Section titled “Key Features”- Multi-provider support — Hetzner Cloud and Scaleway with unified VM size abstraction
- Four AI agents — Claude Code, OpenAI Codex, Google Gemini, Mistral Vibe
- Idea execution — describe what you want, SAM handles the rest with warm node pooling for fast reuse
- Chat-first UX — project pages are chat interfaces with real-time streaming
- File browsing in chat — browse, view, and diff workspace files without leaving the conversation
- File upload & download — attach files to conversations and download from workspaces
- Conversation forking — branch from any point to explore alternatives
- Voice input & TTS — speak your prompts, listen to responses with a persistent audio player
- Command palette — quick navigation via Cmd+K / Ctrl+K
- In-app notifications — progress updates, agent requests, PR creation alerts
- Port exposure — auto-detected dev server ports accessible via unique URLs
- Lightweight workspaces — fast startup by skipping devcontainer build
Architecture at a Glance
Section titled “Architecture at a Glance”SAM is a monorepo with four main components:
| Component | Technology | Purpose |
|---|---|---|
| API | Cloudflare Worker (Hono) | Authentication, resource management, VM proxying, Durable Objects |
| Web UI | React + Vite (Cloudflare Pages) | Dashboard, chat interface, terminal, notifications |
| VM Agent | Go binary | Docker management, PTY sessions, ACP gateway, port scanning |
| Infrastructure | Pulumi (TypeScript) | D1, KV, R2, DNS provisioning |
Quickstart Get up and running with SAM in minutes.
Architecture Overview Deep dive into how every system fits together.