---
id: google-antigravity
version: "0.1.12"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# google-antigravity — Google Antigravity SDK for building AI agents

License: permissive · Maintenance: active · Downloads: 386.8K/mo

## What it is and what it does

Google Antigravity SDK is a Python framework for building AI agents that run on Google's Gemini models. It abstracts away the complexity of managing the agentic loop—the iterative cycle of reasoning, tool calling, and response generation—so you can define agent behavior through system instructions, custom tools, and policies without managing connection lifecycle or state manually.

The SDK provides both high-level convenience (the `Agent` class with async context manager) and lower-level control (direct `Conversation` and `ConnectionStrategy` APIs). It supports multimodal input (images, videos, audio, documents), custom Python functions as tools, integration with Model Context Protocol (MCP) servers, streaming responses and internal reasoning, and policy-based behavior control. It works with both Gemini API and Gemini Enterprise Agent Platform (formerly Vertex AI) via Application Default Credentials.

Use it for:

- Build a code analysis agent that reads repository files and documents, then streams architectural recommendations.
- Create an interactive assistant that accepts user queries and streams real-time responses with visible reasoning steps.
- Wire custom Python functions as tools so an agent can query databases, call APIs, or execute system commands autonomously.
- Connect MCP servers to expose external capabilities (e.g., file system tools, web search) to the agent without custom integration code.
- Deploy a read-only agent for document analysis or Q&A over PDFs and images without enabling write capabilities.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Builds and runs AI agents powered by Google's Gemini, handling the agentic loop, tool wiring, and stateful conversation management so you focus on agent behavior rather than infrastructure.

Yes, with conditions. The SDK is actively maintained (released 1 day ago), permissively licensed, and solves a real problem—abstracting agentic loop complexity. However, it is in Alpha status, depends on 7 runtime libraries, requires Python 3.10+, and mandates installation from PyPI due to compiled binaries. Install if you are building Gemini-powered agents and can tolerate early-stage API changes; avoid if you need production stability guarantees or prefer lightweight agent frameworks.

## Install

pip install google-antigravity
uv add google-antigravity
poetry add google-antigravity

## Installing google-antigravity

Before you install: Medium install friction due to platform-specific compiled binaries included in wheels; must install from PyPI, not from source. Active maintenance with recent release (1 day old) and 3011 repository stars suggest ongoing support.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most production scenarios.

Quickstart:

pip install google-antigravity

import asyncio
from google.antigravity import Agent, LocalAgentConfig

async def main():
    config = LocalAgentConfig()
    async with Agent(config) as agent:
        response = await agent.chat("Hello!")
        print(await response.text())

asyncio.run(main())

Requires Python 3.10+. Relies on a compiled runtime binary included only in PyPI wheels; cloning the repository alone is insufficient. Requires GEMINI_API_KEY environment variable or explicit api_key parameter for Gemini API access.

Verify before relying:

- Whether the 7 runtime dependencies (absl-py, google-genai, mcp, pydantic, uvicorn, websockets, protobuf) are all required or if some are optional for specific features.
- Performance characteristics and latency overhead of the agentic loop abstraction layer.
- Compatibility and tested integration status with specific MCP server implementations.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 386.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

gemini ai agent framework, build autonomous ai agents python, agentic loop abstraction, ai agent with tool calling, stateful conversation management, gemini-agents, agentic-ai, mcp-integration

[View on SkillFed](https://skillfed.io/packages/google-antigravity) · [View on PyPI](https://pypi.org/project/google-antigravity/)