hermes-antigravity

What hermes-antigravity does

hermes-antigravity is a native inference provider plugin that connects Hermes Agent to Google Antigravity / Cloud Code Assist, running Gemini and Claude models with streaming, native tool calling and reasoning tokens. It targets a gap: Google does not issue API keys for consumer or student subscriptions such as Gemini Pro Student, Gemini Advanced or Google One AI Premium, so Hermes could previously reach Google only through AI Studio API keys or Vertex AI service accounts. The plugin signs in with your Google account using OAuth 2.0 PKCE and refreshes tokens automatically.

It is built as a ProviderProfile with auth.py for OAuth, translator.py for converting between OpenAI and Google formats and parsing SSE chunks, and client.py for the streaming transport with host failover. It lists more than 30 models, including gemini-3.8-flash, gemini-3.1-pro, gemini-2.5-pro, claude-sonnet-4-6 and claude-opus-4-6-thinking, routes public model IDs to the suffixed runtime IDs that carry quota, and clamps max_tokens per model family. It is a Python adaptation of the pi-antigravity extension rather than a fork.

Key features

• OAuth 2.0 PKCE sign-in with a Google account and automatic token refresh
• Live model discovery of more than 30 Gemini and Claude models
• Streaming, native tool calling and reasoning or thinking tokens
• Routing of public model IDs to the runtime IDs that carry quota
• Session envelope with stable conversation IDs on every call
• Per-model output caps and wire constants tracked in UPSTREAM_DRIFT.md

When to use it

• Using a Gemini Pro or student subscription in Hermes without a Google API key
• Running Claude and Gemini models through Cloud Code Assist from one Hermes provider
• Auditing divergence from the reference implementation through the drift log

Who it is for: Hermes Agent users with a Gemini Pro, student or Google One AI subscription who have no Google API key.

How it fits with Hermes Agent

A native Hermes Agent provider plugin implemented as a ProviderProfile.

Requirements: Hermes Agent and a Google account whose subscription grants Antigravity / Cloud Code Assist access, such as Gemini Pro, Student or Google One AI plans

Note: GitHub does not identify a standard license for the repository (NOASSERTION), although the README shows an MIT badge.

FAQ