Skip to main content

Runner Codes

What is Runner Codes?​

Runner Codes is a secure execution environment for running code snippets generated by Large Language Models (LLMs) inside Firecracker microVMs. It provides strong isolation, fast boot times, and support for multiple programming languages.

Open Source: https://github.com/andrebassi/runner-codes

Why Firecracker?​

Firecracker is a Virtual Machine Monitor (VMM) developed by AWS that provides:

  • Strong isolation: Full VM-level isolation, not just container namespaces
  • Minimal footprint: ~5MB memory overhead per microVM
  • Fast startup: Boots a VM in ~125ms
  • Security-first design: Built with a minimal device model and seccomp filters

Key Features​

Key Features

Supported Languages​

45+ Supported Languages

tip

See the full Languages Reference for detailed information on each language.

Quick Example​

Here's a simple example of executing Python code in a Firecracker microVM:

Execute Python code via CLI
infra.operator run --lang python --code "print('Hello from Firecracker!')"
Start API server
infra.operator api --port 8080
Execute via HTTP
curl -X POST http://localhost:8080/api/v1/execute \
  -H "Content-Type: application/json" \
  -d '{"language": "python", "code": "print(\"Hello from Firecracker!\")"}'

Output:

JSON data
{
  "stdout": "Hello from Firecracker!\n",
  "stderr": "",
  "exit_code": 0,
  "load_time": "209ms",
  "exec_time": "45ms"
}

Open Source​

Runner Codes is fully open source under the MPL-2.0 license. The entire codebase, including the CLI, HTTP API, guest runner, and documentation, is available on GitHub. We welcome contributions, bug reports, and feature requests from the community.

GitHub: https://github.com/andrebassi/runner-codes

Next Steps​