Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.agno.com/llms.txt

Use this file to discover all available pages before exploring further.

Antigravity wraps Managed Agents in the Gemini API. AntigravityTools lets a regular Agno agent delegate a sub-task to a Google-managed, sandboxed agent that can run code, search the web, and read/write files. The sandbox is provisioned lazily and reused across calls within the same session. Use this when you want an Agno agent (with its own model) to call Antigravity as one tool. To serve Antigravity itself as an AgentOS agent, use AntigravityAgent instead.

​
Prerequisites

uv pip install pyyaml
export GEMINI_API_KEY=your_api_key
pyyaml is only required when using agent_directory.

​
Example

cookbook/91_tools/antigravity/antigravity_tools.py
from agno.agent import Agent
from agno.models.google import Gemini
from agno.tools.antigravity import AntigravityTools

agent = Agent(
    name="Research Assistant",
    model=Gemini(id="gemini-2.5-pro"),
    tools=[AntigravityTools()],
    markdown=True,
    instructions=[
        "When a task benefits from a sandboxed Linux environment with web search "
        "and code execution, delegate it via run_antigravity_task.",
        "Otherwise answer directly.",
    ],
)

agent.print_response(
    "Use the sandbox to find the latest stable Python release and summarize what changed."
)

​
Toolkit Params

ParameterTypeDefaultDescription
api_keystrNoneGemini API key. Falls back to GEMINI_API_KEY.
base_urlstrGemini v1betaAPI base URL.
agentstr"waverunner"Base agent identifier, or a custom agent name to invoke.
default_sourcesList[Dict]NoneGCS / repository / inline sources to seed the sandbox on first use.
persistentboolTrueReuse one sandbox per session (cached in agent.session_state).
timeoutint600Per-request timeout in seconds.
instructionsstrNoneCustom toolkit instructions.
add_instructionsboolFalseWhether to add the default instructions.
agent_directorystrNonePath to an agent directory (agent.yaml + AGENTS.md + workspace/ + skills/). Parses it, sets agent to the yaml id, seeds default_sources, and registers the agent.
registerboolTrueWhen agent_directory is set, POST the agent definition to /agents on construction (idempotent).
agent_directory conflicts with explicit agent= or default_sources= and will raise.

​
Tools

FunctionDescription
run_antigravity_taskDelegate a task to the sandbox; reuses the per-session sandbox.
run_custom_antigravity_agentInvoke a named custom agent by name.
create_custom_antigravity_agentRegister a custom agent (sources or base_env_id).
update_custom_antigravity_agentPatch a custom agent’s instructions/description.
get_custom_antigravity_agentFetch a single custom agent definition.
list_antigravity_agentsList all custom agents.
list_antigravity_agent_versionsList versions of a custom agent.
delete_antigravity_agentDelete a custom agent.
download_antigravity_environment_snapshotDownload the sandbox filesystem as a tar (environment_id="current" resolves from session state).
You can use include_tools or exclude_tools to modify the list of tools the agent has access to. Learn more about selecting tools.

​
Concepts

​
Session persistence

run_antigravity_task caches the sandbox’s environment_id in the calling agent’s session_state, so repeated calls within the same session reuse the sandbox (files and installed packages persist). Persistence requires non-streaming responses. The streaming SSE response does not expose environment_id.

​
Custom agents (Agents API)

The toolkit exposes the full /agents CRUD surface. Register a named agent once, then invoke it by name with run_custom_antigravity_agent. Each named agent gets its own per-session sandbox.

​
Agent directories

Pass agent_directory to wire a local folder (agent.yaml + AGENTS.md + workspace/ + skills/) into the toolkit. On construction it parses the folder, registers the agent with the API, and routes subsequent run_antigravity_task calls at that named agent. 
AntigravityTools(agent_directory="./my-agent")

​
Examples

Delegate a task

A Gemini agent delegates a research sub-task to the sandbox.

Agents API CRUD

Create, invoke, and delete custom agents through tools.

Agent from a directory

Wire a local agent.yaml folder into the toolkit.

Environment snapshot

Run a sandbox task then download the environment as a tar.

​
Developer Resources