Agno

Agno includes a SuperserveTools toolkit for running agent-generated code in isolated cloud sandboxes. The sandbox persists across tool calls, so files and installed packages remain available throughout the session.

SuperserveTools is available in Agno 2.7.4 and later.

Setup

Install Agno, the OpenAI model provider, and the Superserve SDK:

uv pip install -U "agno>=2.7.4" openai superserve
export OPENAI_API_KEY=sk-...
export SUPERSERVE_API_KEY=ss_live_...

See API keys to create a Superserve API key.

Run an Agno agent in a sandbox

SuperserveTools gives the agent tools for Python and shell execution, file operations, sandbox inspection, preview URLs, and lifecycle management.

from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.tools.superserve import SuperserveTools

agent = Agent(
    name="Sandboxed Python Agent",
    model=OpenAIResponses(id="gpt-5.5"),
    tools=[SuperserveTools(timeout=600)],
    instructions=[
        "Execute requested code with run_python_code or run_command.",
        "Return the code and its actual execution output.",
    ],
)

agent.print_response(
    "Generate the first 10 Fibonacci numbers, then calculate their sum and average."
)

The toolkit creates a Python-ready sandbox on the first tool call. With persistent=True, the default, Agno stores its ID in session state and reuses the same sandbox across tool calls and runs in that session. Sync and async agents use the same sandbox automatically.

Configure the sandbox

Pass Superserve sandbox options directly to the toolkit:

tools = [
    SuperserveTools(
        template="superserve/node-22",
        timeout=600,
        auto_delete_seconds=3600,
        secrets={"OPENAI_API_KEY": "openai-prod"},
        enable_pause_sandbox=True,
        enable_resume_sandbox=True,
    )
]

Option	Purpose
`template`	Select the sandbox runtime. The default is `superserve/code-interpreter`.
`sandbox_id`	Connect the toolkit to an existing sandbox.
`timeout`	Set the sandbox lifetime before it is automatically stopped.
`auto_delete_seconds`	Set a hard time-to-live after which the sandbox is deleted.
`secrets`	Bind team secrets without exposing their values in the sandbox.
`enable_pause_sandbox` and `enable_resume_sandbox`	Let the agent pause and resume its current sandbox.
`all`	Enable every toolkit function, including opt-in lifecycle and secret tools.

Recipes

MCP

Coding Agents

Personal Agents

Managed Agents

Agent Harnesses

Setup

Run an Agno agent in a sandbox

Configure the sandbox

Resources

Agno toolkit reference

Agno cookbook example

​Setup

​Run an Agno agent in a sandbox

​Configure the sandbox

​Resources

Agno toolkit reference

Agno cookbook example

Setup

Run an Agno agent in a sandbox

Configure the sandbox

Resources