# Antigravity Python SDK: The First 30 Minutes

> A guided onboarding path to the Antigravity SDK, focusing on rapid orientation, core abstractions, and the safety-first execution model.

This is a Grok-Wiki source-grounded repository wiki. Use the complete Markdown link when an agent needs the full repo context.

## Context Links

- [Complete Markdown wiki](https://grok-wiki.com/public/wiki/google-antigravity-antigravity-sdk-python-2abd361a7867/llms-full.txt)
- [Complete Markdown alias](https://grok-wiki.com/public/wiki/google-antigravity-antigravity-sdk-python-2abd361a7867.md)
- [Human interactive wiki](https://grok-wiki.com/public/wiki/google-antigravity-antigravity-sdk-python-2abd361a7867)
- [GitHub repository](https://github.com/google-antigravity/antigravity-sdk-python)

## Repository

- Repository: google-antigravity/antigravity-sdk-python

- Generated: 2026-05-19T20:42:20.250Z
- Updated: 2026-05-21T21:35:20.879Z
- Runtime: Antigravity CLI
- Format: First 30 Minutes
- Pages: 12

## Pages

- [Start Here](https://grok-wiki.com/public/wiki/google-antigravity-antigravity-sdk-python-2abd361a7867/pages/01-start-here.md): What this repo is, the fastest read order, the entry points to open first, and the vocabulary (Agent, Conversation, Hook, Trigger) a new reader needs.
- [Rapid Setup & First Run](https://grok-wiki.com/public/wiki/google-antigravity-antigravity-sdk-python-2abd361a7867/pages/02-rapid-setup-first-run.md): Installation nuances (PyPI wheels vs source clones), environment variables, and the hello_world.py entry point for immediate verification.
- [The Safety Model: Policies vs Capabilities](https://grok-wiki.com/public/wiki/google-antigravity-antigravity-sdk-python-2abd361a7867/pages/03-the-safety-model-policies-vs-capabilities.md): Hidden constraints: why the SDK raises ValueError for write tools without policies, and how to optimize tokens by disabling tools vs denying them.
- [Understanding the Agentic Loop](https://grok-wiki.com/public/wiki/google-antigravity-antigravity-sdk-python-2abd361a7867/pages/04-understanding-the-agentic-loop.md): The three-layer architecture: Layer 1 (Simplified Agent), Layer 2 (Stateful Session), and Layer 3 (Transport Adapters).
- [Agent Lifecycle & Context](https://grok-wiki.com/public/wiki/google-antigravity-antigravity-sdk-python-2abd361a7867/pages/05-agent-lifecycle-context.md): How the Agent class manages resource cleanup via AsyncExitStack and provides high-level streaming interfaces for thoughts and tool calls.
- [Stateful Conversations & History](https://grok-wiki.com/public/wiki/google-antigravity-antigravity-sdk-python-2abd361a7867/pages/06-stateful-conversations-history.md): Deep dive into Conversation state, step history accumulation, and the low-level send/receive_steps API for granular interaction control.
- [Tooling & MCP Integration](https://grok-wiki.com/public/wiki/google-antigravity-antigravity-sdk-python-2abd361a7867/pages/07-tooling-mcp-integration.md): Extending agent capabilities via native Python functions and the Model Context Protocol (MCP) bridge for stdio and SSE servers.
- [Hooks & Policy Precedence](https://grok-wiki.com/public/wiki/google-antigravity-antigravity-sdk-python-2abd361a7867/pages/08-hooks-policy-precedence.md): The priority-based policy model (Specific > Wildcard) and how to implement custom middleware using pre/post-step hooks.
- [Interactive & Human-in-the-Loop](https://grok-wiki.com/public/wiki/google-antigravity-antigravity-sdk-python-2abd361a7867/pages/09-interactive-human-in-the-loop.md): Implementing interactive flows using run_interactive_loop and ask_user policy handlers for manual tool call approval.
- [Event-Driven Triggers](https://grok-wiki.com/public/wiki/google-antigravity-antigravity-sdk-python-2abd361a7867/pages/10-event-driven-triggers.md): Running background tasks that react to external events (e.g., timers via every()) and push asynchronous messages into the agent session.
- [Multimodal & Content Ingestion](https://grok-wiki.com/public/wiki/google-antigravity-antigravity-sdk-python-2abd361a7867/pages/11-multimodal-content-ingestion.md): Handling rich media: using from_file for automatic MIME resolution and direct constructor instantiation for in-memory bytes (Image, Video, Document).
- [Beyond 30 Minutes: Next Steps](https://grok-wiki.com/public/wiki/google-antigravity-antigravity-sdk-python-2abd361a7867/pages/12-beyond-30-minutes-next-steps.md): Synthesis of the core model, pointers to deep-dive examples (Middleware, Subagents), and how to contribute to the SDK.

## Source Files

- `CONTRIBUTING.md`
- `examples/deep_dives/async_chat.py`
- `examples/deep_dives/interactive_cli.py`
- `examples/deep_dives/multimodal_pipeline.py`
- `examples/deep_dives/README.md`
- `examples/getting_started/custom_tools.py`
- `examples/getting_started/hello_world.py`
- `examples/getting_started/hooks.py`
- `examples/getting_started/human_in_the_loop.py`
- `examples/getting_started/multimodal.py`
- `examples/getting_started/policies.py`
- `examples/getting_started/streaming.py`
- `examples/getting_started/subagents.py`
- `examples/getting_started/triggers.py`
- `examples/README.md`
- `examples/resources/sample_doc.txt`
- `google/antigravity/agent.py`
- `google/antigravity/connections/connection.py`
- `google/antigravity/conversation/conversation.py`
- `google/antigravity/conversation/README.md`
- `google/antigravity/hooks/hook_runner.py`
- `google/antigravity/hooks/hooks.py`
- `google/antigravity/hooks/policy.py`
- `google/antigravity/mcp/bridge.py`
- `google/antigravity/mcp/README.md`
- `google/antigravity/tools/tool_runner.py`
- `google/antigravity/triggers/README.md`
- `google/antigravity/triggers/trigger_runner.py`
- `google/antigravity/triggers/triggers.py`
- `google/antigravity/types.py`
- `google/antigravity/utils/interactive_test.py`
- `google/antigravity/utils/interactive.py`
- `pyproject.toml`
- `README.md`