agno-opensandbox-toolkit

OpenSandbox support for the Agno agent framework.

Give your Agno agents the ability to execute shell commands, manage files, and run code in secure, isolated OpenSandbox containers.

Installation

# Base: shell commands + file operations
uv add agno-opensandbox-toolkit

# With code interpreter support (Python, JS, Java, Go, Bash)
uv add "agno-opensandbox-toolkit[code-interpreter]"

Prerequisites

You need a running OpenSandbox server. The quickest way:

uv pip install opensandbox-server
opensandbox-server init-config ~/.sandbox.toml --example docker
opensandbox-server

See the OpenSandbox docs for full setup instructions.

Quick Start

from agno.agent import Agent
from agno.models.openai import OpenAIChat
from agno_opensandbox_toolkit import OpenSandboxTools

agent = Agent(
    name="Sandbox Agent",
    model=OpenAIChat(id="gpt-4o-mini"),
    tools=[OpenSandboxTools()],
    markdown=True,
)

agent.print_response("Create a file /tmp/hello.py that prints 'Hello from OpenSandbox!', then run it")

Configuration

Available Tools

License

The project is published under the BSD 3-Clause license. For details see the LICENSE file.