Antigravity

AntigravityAgent wraps Managed Agents in the Gemini API so a Google-managed, sandboxed agent can be served through AgentOS. A single API call spins up a secure Linux environment where the agent plans, executes code, searches the web, and reads/writes files. AgentOS handles sessions, streaming, and the UI.

Save the following as antigravity_agent.py. After the Install step, start it with python antigravity_agent.py. Later snippets are alternatives or fragments using the same imports.

from agno.agents.antigravity import AntigravityAgent
from agno.db.sqlite import SqliteDb
from agno.os import AgentOS

agent = AntigravityAgent(name="Antigravity")

agent_os = AgentOS(
    agents=[agent],
    db=SqliteDb(db_file="tmp/agentos.db"),
)
app = agent_os.get_app()

if __name__ == "__main__":
    agent_os.serve(app="antigravity_agent:app", reload=True)

Install

uv pip install "agno[os]"
export GEMINI_API_KEY=...

Parameters

Concepts

Sessions and environment persistence

Each interaction provisions a managed Linux sandbox and returns an environment_id. When a db is configured, AntigravityAgent persists that id (and the previous interaction id) in the session, so subsequent turns with the same session_id request reuse of that sandbox. Reuse is subject to provider retention: inactive environments expire after seven days, and an expired environment ID returns 404.

Without a db, every turn provisions a fresh sandbox (no cross-turn reuse).

from agno.agents.antigravity import AntigravityAgent
from agno.db.sqlite import SqliteDb

agent = AntigravityAgent(name="Antigravity", db=SqliteDb(db_file="tmp/antigravity.db"))

agent.print_response("Write a file notes.txt containing 'hello'.", session_id="s1")
agent.print_response("Read notes.txt back to me.", session_id="s1")  # same sandbox

Seeding the environment with sources

Pass sources to preload files into the sandbox before the agent runs. Three source types are supported: inline content, Google Cloud Storage, and Git repositories.

agent = AntigravityAgent(
    name="Antigravity",
    sources=[
        {"type": "inline", "content": "agno is an agent framework", "target": "/workspace/about.txt"},
        # {"type": "gcs", "source": "gs://my-bucket/data/", "target": "/data"},
        # {"type": "repository", "source": "https://github.com/user/repo", "target": "/repo"},
    ],
)

The provider source limits are 1 MB per inline file and 2 MB total. Agno's directory helper still applies its own 75 KB per-file limit and skips larger or binary files.

Custom agents

Register the custom agent through the provider's current registration API, then pass its existing ID to Agno:

agent = AntigravityAgent(name="Haiku Bot", agent="your_registered_agent_id")
agent.print_response("Topic: autumn.")

Defining an agent from a directory

from_agent_directory builds an agent from a local folder following the Managed Agents layout: agent.yaml (id, base_agent, description, system_instruction), AGENTS.md (overrides system_instruction), workspace/ (mounted at the sandbox root), and skills/ (mounted under /.agents/skills/). The default register=True calls the registration helper described above. Use register=False to inspect a local definition without registration; this does not create a usable remote custom agent.

Create my-agent/agent.yaml first:

id: my-haiku-agent
base_agent: antigravity-preview-05-2026
system_instruction: Answer with a haiku.

from agno.agents.antigravity import AntigravityAgent

agent = AntigravityAgent.from_agent_directory("./my-agent", register=False)
print(agent.custom_agent_name)

Register the definition through the provider API before invoking that custom ID.

Downloading an environment snapshot

Pull the sandbox filesystem (after a run modified it) as a tar archive.

agent = AntigravityAgent(name="Antigravity", db=SqliteDb(db_file="tmp/antigravity.db"))
agent.print_response("Create /workspace/report.md", stream=False, session_id="s1")
agent.download_environment_snapshot("snapshot.tar", session_id="s1")

Examples

Developer Resources

• Cookbook examples
• Antigravity as a tool