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: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.
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.
timeout only pauses an idle sandbox; it does not delete it. Call shutdown_sandbox(agent) when you are done, as in the example, and set auto_delete_seconds as a backstop for runs that exit early.
Configure the sandbox
Pass Superserve sandbox options directly to the toolkit:Resources
Agno toolkit reference
Review every toolkit option and function.
Agno cookbook example
Open the runnable example in the Agno repository.