AntiGravity SDK & IDE
v1.2.0Google's agentic coding platform, Python SDK, Multi-Agent Orchestration & AI IDE
Google AntiGravity is een geavanceerd agentic development platform bestaande uit een Python SDK voor op maat gemaakte multi-agent workflows en de gratis AI-native AntiGravity IDE.
Omgevingen
Python SDK
- Programmatische API voor agent-customization en orchestratie
- Eenvoudige integratie in bestaande Python pipelines en projecten
- Ontworpen voor backend-services en autonome achtergrondagents
AntiGravity IDE (Desktop)
- Gratis AI-native IDE (in public preview sinds november 2025)
- Ingebouwde Manager Surface voor visuele multi-agent interacties
- Gemini-native alternatief voor premium IDEs zoals Cursor en Windsurf
Terminal CLI
- Geprefabriceerde interactieve loop via `agent.run_interactive_loop()`
- Toont agent gedachten (thinking tokens) en handelingen in real-time
- Volledige ondersteuning voor Ctrl+C/D signalen en sessiebeheer
Installatie & Setup
pip install google-antigravity
Alternatieven:
poetry add google-antigravity # Poetryuv pip install google-antigravity # UV (Fast package manager)Vereist Python 3.10+ · GEMINI_API_KEY omgevingsvariabele of Google AI Studio OAuth
Voor toegang tot de Gemini-modellen is een API-key vereist. Verkrijg deze via Google AI Studio op https://aistudio.google.com/app/api-keys. De key wordt automatisch uit de omgeving gelezen of kan expliciet in de code worden meegegeven.
Core Architectuur
De Google AntiGravity SDK is gebouwd op drie fundamentele pilaren die samen de runtime, context en netwerklaag van een agent beheren:
| Pilaar | Klasse / Interface | Functie / Rol |
|---|---|---|
| Agent | Agent & LocalAgentConfig | Het hoofdingangspunt. Beheert configuratie (modellen, capabilities, tools, policies) en de sessie-lifecycle. |
| Conversation | Conversation | Verantwoordelijk voor de stateful sessie, turn-history, context-compacering en streaming methoden zoals chat(). |
| Connection | Connection | Abstracte transportlaag die communicatie met de backend (lokaal of cloud) regelt en de API loskoppelt van transportdetails. |
Kernmogelijkheden
- Autonoom bestandsbeheer via ingebouwde tools: list_directory, search_directory, view_file, create_file en edit_file.
- Multi-Agent delegatie: Hoofdagents kunnen subagents starten via start_subagent om complexe deeltaken parallel uit te voeren.
- Structured Output: Ingebouwde integratie met Pydantic-schemas om gegarandeerd correct geformatteerde JSON te ontvangen.
- Image & Media Generation: Ingebouwde generate_image tool voor het genereren en bewerken van visuele UI/UX assets.
- Context Compaction: Automatisch beheer en compressie van conversatiegeschiedenis om token-limieten over lange sessies te respecteren.
- Periodic & System Triggers: Agents kunnen reageren op tijd-gebaseerde cronjobs of bestandsysteem-veranderingen in de achtergrond.
Safety Policies & Sandbox
AntiGravity maakt gebruik van een declaratief safety policy engine dat beslissingen neemt op basis van prioriteit. Standaard is run_command geblokkeerd of wordt de gebruiker om goedkeuring gevraagd.
| Prioriteit | Policy Type | Werking |
|---|---|---|
| 1 | Specific Deny | policy.deny("tool_name", when=...), blokkeert direct op basis van parameters (bv. rm in CommandLine). |
| 2 | Specific Ask | policy.ask_user("tool_name", handler=...), vereist handmatige goedkeuring via een callback handler. |
| 3 | Specific Allow | policy.allow("tool_name"), keurt specifieke tool-uitvoering direct goed. |
| 4 | Wildcard Deny | policy.deny_all() of deny("*"), blokkeert alle tools bij gebrek aan specifiekere regels. |
| 5 | Wildcard Ask | policy.ask_user("*"), vraagt goedkeuring voor alle niet-gespecificeerde tools. |
| 6 | Wildcard Allow | policy.allow_all() of allow("*"), staat alles toe (alleen aanbevolen voor lokale sandboxontwikkeling). |
Workspace containment: Als workspaces is ingesteld in de LocalAgentConfig, past de SDK automatisch policy.workspace_only() toe. Dit beperkt file-tools (view, create, edit) tot uitsluitend de opgegeven directory-paden.
Hooks & MCP Extensies
Lifecycle Hooks
- Pre-turn en post-turn hooks om conversatietoestand aan te passen
- PreToolCallDecideHook om parameters te controleren of te herschrijven
- PostToolCallHook om de resultaten van tool calls te loggen of auditen
Model Context Protocol (MCP)
- McpStdioServer voor lokaal beheerde sub-processen
- McpSseServer voor verbindingen met externe remote MCP-services over HTTP
- FastMCP-compatibiliteit voor eenvoudige tool-declaratie in Python
Observability & Token Tracking
- Nauwkeurige tracking van prompt_token_count en candidates_token_count via agent.conversation.total_usage.
- Monitoring van thoughts_token_count (denk-tokens) om kosten van reasoning-modellen (Gemini 2.0/3.0 Reasoning) te beheersen.
- Standaard Python logging namespaces (google.antigravity) voor gedetailleerde debugging en audit traces.
Bijgewerkt: 2026-05-28