← all repositories
google-antigravity/antigravity-sdk-python

Google’s Python SDK for Gemini agents ships with a compiled catch

It abstracts the busywork of running Gemini agents—state, tools, policies, and streaming—behind a Python context manager.

2.6k stars Python AgentsCoding Assistants
antigravity-sdk-python
Velocity · 7d
+22
★ / day
Trend
accelerating
star history

What it does

The Google Antigravity SDK is a Python library for building AI agents on top of Gemini. It wraps the full agent lifecycle—binary discovery, tool registration, hook execution, and stateful session management—inside a high-level Agent class and a lower-level Conversation API. You feed it prompts, custom Python functions, multimodal files, or external MCP servers, and it handles the back-and-forth with the model. The whole thing is async and streams tokens, reasoning steps, and tool calls in real time.

The interesting bit

The SDK distributes a compiled runtime binary inside its PyPI wheels, so cloning the repository is intentionally insufficient to run it—a curious packaging choice for an open-source Python library. It also defaults to read-only mode and exposes a declarative policy engine, which is more safety scaffolding than you usually see in agent frameworks.

Key highlights

  • Agent and Conversation APIs cover both quickstarts and low-level session control.
  • Native streaming of tokens, reasoning steps, and ToolCall events.
  • Multimodal support for images, video, audio, and documents from memory or disk.
  • Built-in MCP integration and a declarative policy layer that defaults to read-only.
  • Background triggers for pushing external events into the agent loop.

Caveats

  • Requires installing from PyPI; the compiled runtime binary is not present in the source repository, so you cannot run the SDK from a raw clone.

Verdict

This is a batteries-included scaffold for developers building on Gemini who want safety policies, streaming, and multimodal ingestion. If you need a fully source-available runtime or are not in the Gemini ecosystem, it is a poor fit.

Frequently asked

What is google-antigravity/antigravity-sdk-python?
It abstracts the busywork of running Gemini agents—state, tools, policies, and streaming—behind a Python context manager.
Is antigravity-sdk-python open source?
Yes — google-antigravity/antigravity-sdk-python is open source, released under the Apache-2.0 license.
What language is antigravity-sdk-python written in?
google-antigravity/antigravity-sdk-python is primarily written in Python.
How popular is antigravity-sdk-python?
google-antigravity/antigravity-sdk-python has 2.6k stars on GitHub and is currently accelerating.
Where can I find antigravity-sdk-python?
google-antigravity/antigravity-sdk-python is on GitHub at https://github.com/google-antigravity/antigravity-sdk-python.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.