Most AI agents are like eager interns: they write code, hand it to you, and pray it works. When it breaks, you have to fix it. (ノಠ益ಠ)ノ彡┻━┻

Agent Sandbox Runtime is different. It's a secure, self-correcting runtime that treats code generation like a loop, not a one-off:

1. Generate code (using extensive Swarm Intelligence 🐝)
2. Execute inside a locked-down Docker container 🔒
3. Explode? 💥 Catch the error, analyze the stack trace.
4. Fix it. 🛠️ Rewrite the code.
5. Repeat until it works or hits the retry limit.

The result? Code that actually runs. (⌐■_■)

We call it the Reflexion Loop. It's the secret sauce that bumps success rates from ~60% to 92%.

graph LR
    A[User Task] --> B(Generate)
    B --> C{Sandbox Execution}
    C -->|✅ Success| D[Return Result]
    C -->|❌ Failure| E[Critique & Fix]
    E --> B
    style C fill:#ff9,stroke:#333,stroke-width:2px
    style E fill:#f9f,stroke:#333,stroke-width:2px

It's not just one LLM. It's a council of specialized agents working in a peer-to-peer structure:

• 🎩 The Architect - Plans the structure.
• 💻 The Coder - Writes the raw Python.
• 🧐 The Critic - Hunts for logic bugs.
• 🛡️ The Security - Ensures no shenanigans (rm -rf /).

Under the hood, this isn't just a wrapper. It's a full-blown runtime environment.

Every line of code runs inside an ephemeral Docker container.

• No Network Access: Code cannot call home or download malware. [OFFLINE]
• Resource Limits: Capped at 512MB RAM / 0.5 CPU. No fork bombs. [CAPPED]
• Timeouts: Hard cut-off at 5 seconds. No infinite loops. [STRICT]
• Ephemeral: Container dies immediately after execution. No persistence. [CLEAN]

Switch intelligence providers instantly via .env. logic remains the same.

• GROQ (Llama 3 70B) - Recommended for speed (750ms)
• OPENAI (GPT-4o) - Best for complex logic
• ANTHROPIC (Claude 3.5 Sonnet) - Best for code quality
• OLLAMA (DeepSeek Coder / Qwen) - 100% Local & Private

Uses graph-based state management to persist the conversation context and learning history during the reflection loop.

• Checkpointing: Resumes from last failed state.
• Reflection History: Remembers why previous 2 attempts failed.
• Structured Output: Enforced JSON schema for all internal communication.

The Awakening (Swarm Init) 🌌	Code Alchemy (Generation) ⚗️

The Solution 📜	Victory (Result) 🏆

See the agent build a full snake game from scratch in under 30 seconds.

We put this runtime up against the giants. Here is the tale of the tape:

Validated on 12 complex algorithmic challenges ranging from Fibonacci sequences to custom data structure implementations.

Get up and running faster than you can say "Segmentational Fault".

docker run -e GROQ_API_KEY=your_key ghcr.io/ixchio/agent-sandbox-runtime

# 1. Clone the Scroll
git clone https://github.com/ixchio/agent-sandbox-runtime.git
cd agent-sandbox-runtime

# 2. Summon Dependencies
pip install -e .

# 3. Configure Your Mana (API Keys)
cp .env.example .env
# (Add your key: GROQ_API_KEY, OPENAI_API_KEY, etc.)

# 4. Cast Spell
agent-sandbox run "Calculate the first 10 prime numbers"

Adjust your runtime environment via .env or environment variables.

We are building the future of agentic coding. Want to help? Check out CONTRIBUTING.md for the rules of engagement.

We love PRs! (ﾉ◕ヮ◕)ﾉ*:･ﾟ✧