vrn21/bouvet

Sandbox for Agents

102

stars

51

commits

Rust

primary language

Aug 9, 2026

updated

deepwiki.com/vrn21/bouvet
agents
ai
mcp
rust
sandbox

README

Bouvet Logo

Bouvet

Isolated code execution sandboxes for AI agents

AboutHow It WorksMCP ToolsDocumentation

License Rust Firecracker Ask DeepWiki


What is Bouvet?

Bouvet (boo-veh) is an MCP server that creates secure, isolated sandboxes for AI agents to execute code.

When an AI agent needs to run Python, Node.js, or shell commands, Bouvet spins up a lightweight microVM in ~200ms. The code runs in complete isolation separate kernel filesystem and network then the sandbox is destroyed. Nothing persists, nothing leaks.

The problem it solves: AI agents need a safe place to run untrusted code. Docker isn't enough containers share the host kernel. Bouvet uses Firecracker microVMs for true hardware-level isolation the same technology that powers AWS Lambda.

Who it's for: Developers building AI agents with Claude, Cursor, or any MCP-compatible client who need secure code execution without managing infrastructure.


How It Works

┌─────────────┐     ┌─────────────┐     ┌─────────────────────────┐
│  AI Agent   │────▶│ bouvet-mcp  │────▶│  Firecracker microVM    │
│  (Claude)   │     │ (MCP Server)│     │  ┌─────────────────┐    │
└─────────────┘     └─────────────┘     │  │  bouvet-agent   │    │
                                        │  │  (guest daemon) │    │
                                        │  └─────────────────┘    │
                                        └─────────────────────────┘
  1. AI agent requests a sandbox via MCP
  2. Bouvet boots a microVM with your chosen toolchain
  3. Agent executes code, reads/writes files
  4. Sandbox is destroyed when done

Each microVM has ~256MB RAM, 1 vCPU, and a full Linux environment with Python, Node.js, and common dev tools pre-installed.


Features

  • True Isolation — Each sandbox is a separate VM, not a container
  • Fast Startup — Warm pool enables sub-200ms sandbox creation
  • Multi-Language — Python, Node.js, Rust, Bash, and shell access
  • MCP Native — Works with Claude, Cursor, and any MCP client

MCP Tools

ToolDescription
create_sandboxCreate a new isolated sandbox
destroy_sandboxDestroy a sandbox and free resources
list_sandboxesList all active sandboxes
execute_codeRun Python, Node.js, or Bash code
run_commandExecute shell commands
read_fileRead file contents from sandbox
write_fileWrite file contents to sandbox
list_directoryList directory contents

Documentation

DocumentDescription
Self-Hosting GuideDeploy Bouvet on your own infrastructure
ConfigurationEnvironment variables and options
ArchitectureTechnical deep dive

Testimonials


"Bouvet provides a stable, no-nonsense interface for managing isolated execution environments that works exactly as you'd expect. It handles basic file operations and code execution reliably, making it a utilitarian choice for tasks requiring simple, ephemeral sandboxes."

— Gemini 3 Pro


"The sandbox spins up in seconds and just works—no configuration headaches, no surprises. It's not flashy, but it does exactly what it promises without getting in your way."

— Claude 4.5 Opus


Behind the name: Bouvet (boo-veh)

Everything began with a single, uncompromising promise: absolute isolation. In an ecosystem where code execution is often messy, shared, and persistent, we wanted to create a void a perfect, ephemeral vacuum where software could live for a moment and then disappear without a trace.

This pursuit of solitude brought us to Bouvet Island, it is one of the most remote places on Earth uninhabited, untouched, and thousands of miles from civilization. It is the physical embodiment of what we've built in software: a harsh, beautiful, and completely isolated environment where nothing comes in, and nothing leaves.


License

MIT — See LICENSE for details.


Built with 🧨 Firecracker and 🦀 Rust

Contributors

vrn21

51 commits

vrn21/bouvet

Sandbox for Agents

102

stars

51

commits

Rust

primary language

Aug 9, 2026

updated

deepwiki.com/vrn21/bouvet
agents
ai
mcp
rust
sandbox

README

Bouvet Logo

Bouvet

Isolated code execution sandboxes for AI agents

AboutHow It WorksMCP ToolsDocumentation

License Rust Firecracker Ask DeepWiki


What is Bouvet?

Bouvet (boo-veh) is an MCP server that creates secure, isolated sandboxes for AI agents to execute code.

When an AI agent needs to run Python, Node.js, or shell commands, Bouvet spins up a lightweight microVM in ~200ms. The code runs in complete isolation separate kernel filesystem and network then the sandbox is destroyed. Nothing persists, nothing leaks.

The problem it solves: AI agents need a safe place to run untrusted code. Docker isn't enough containers share the host kernel. Bouvet uses Firecracker microVMs for true hardware-level isolation the same technology that powers AWS Lambda.

Who it's for: Developers building AI agents with Claude, Cursor, or any MCP-compatible client who need secure code execution without managing infrastructure.


How It Works

┌─────────────┐     ┌─────────────┐     ┌─────────────────────────┐
│  AI Agent   │────▶│ bouvet-mcp  │────▶│  Firecracker microVM    │
│  (Claude)   │     │ (MCP Server)│     │  ┌─────────────────┐    │
└─────────────┘     └─────────────┘     │  │  bouvet-agent   │    │
                                        │  │  (guest daemon) │    │
                                        │  └─────────────────┘    │
                                        └─────────────────────────┘
  1. AI agent requests a sandbox via MCP
  2. Bouvet boots a microVM with your chosen toolchain
  3. Agent executes code, reads/writes files
  4. Sandbox is destroyed when done

Each microVM has ~256MB RAM, 1 vCPU, and a full Linux environment with Python, Node.js, and common dev tools pre-installed.


Features

  • True Isolation — Each sandbox is a separate VM, not a container
  • Fast Startup — Warm pool enables sub-200ms sandbox creation
  • Multi-Language — Python, Node.js, Rust, Bash, and shell access
  • MCP Native — Works with Claude, Cursor, and any MCP client

MCP Tools

ToolDescription
create_sandboxCreate a new isolated sandbox
destroy_sandboxDestroy a sandbox and free resources
list_sandboxesList all active sandboxes
execute_codeRun Python, Node.js, or Bash code
run_commandExecute shell commands
read_fileRead file contents from sandbox
write_fileWrite file contents to sandbox
list_directoryList directory contents

Documentation

DocumentDescription
Self-Hosting GuideDeploy Bouvet on your own infrastructure
ConfigurationEnvironment variables and options
ArchitectureTechnical deep dive

Testimonials


"Bouvet provides a stable, no-nonsense interface for managing isolated execution environments that works exactly as you'd expect. It handles basic file operations and code execution reliably, making it a utilitarian choice for tasks requiring simple, ephemeral sandboxes."

— Gemini 3 Pro


"The sandbox spins up in seconds and just works—no configuration headaches, no surprises. It's not flashy, but it does exactly what it promises without getting in your way."

— Claude 4.5 Opus


Behind the name: Bouvet (boo-veh)

Everything began with a single, uncompromising promise: absolute isolation. In an ecosystem where code execution is often messy, shared, and persistent, we wanted to create a void a perfect, ephemeral vacuum where software could live for a moment and then disappear without a trace.

This pursuit of solitude brought us to Bouvet Island, it is one of the most remote places on Earth uninhabited, untouched, and thousands of miles from civilization. It is the physical embodiment of what we've built in software: a harsh, beautiful, and completely isolated environment where nothing comes in, and nothing leaves.


License

MIT — See LICENSE for details.


Built with 🧨 Firecracker and 🦀 Rust

Contributors

vrn21

51 commits

Languages

Rust

80.0%

Shell

9.6%

HCL

6.0%

Dockerfile

2.3%

Makefile

2.1%