BitMiracle-AI/Dormice

What it solves

Cloud sandbox platforms often charge by the second, making sandboxes disposable. Dormice provides a self-hosted, permanent sandbox platform for AI agents that allows sandboxes to persist across sessions without incurring continuous costs when idle.

How it works

Dormice runs as a single daemon on a Linux host using Docker and gVisor. It manages the lifecycle of sandboxes through a state machine: active $\rightarrow$ frozen $\rightarrow$ stopped $\rightarrow$ archived.

• Idempotent Access: Using a unique key, the same sandbox is always returned regardless of its current state (created, woken, or restored).
• Resource Efficiency: Idle sandboxes are automatically cooled down. Freezing can reduce a 1 GiB sandbox to ~5 MiB of resident memory with a wake-up time of ~50 ms.
• Storage: Optional S3-compatible archiving allows stopped sandboxes to be packed and shipped to external storage to free up local disk space.
• Interoperability: It implements the E2B protocol, allowing the official e2b SDK to work with Dormice by simply changing configuration URLs.

Who it’s for

Developers building AI agents that require persistent, isolated Linux environments for executing code or managing files, who prefer self-hosting over managed cloud services.

Highlights

• E2B Compatible: Works with the official e2b SDK without code changes.
• Zero-Cost Idle: Automatic lifecycle management to minimize memory and RAM usage.
• Simple Deployment: Deploys as a single binary with a SQLite ledger and no external database requirements.
• Integrated Tooling: Includes a native TypeScript SDK, a CLI (dor), and a built-in web console for monitoring and managing sandboxes.