https://github.com/mrhisyammm/hermes-antigravity-auth
Google Antigravity IDE OAuth auth plugin and proxy provider for Hermes Agent
https://github.com/mrhisyammm/hermes-antigravity-auth
claude gemini google-antigravity hermes hermes-agent hermes-plugin oauth plugin
Last synced: 27 days ago
JSON representation
Google Antigravity IDE OAuth auth plugin and proxy provider for Hermes Agent
- Host: GitHub
- URL: https://github.com/mrhisyammm/hermes-antigravity-auth
- Owner: mrhisyammm
- License: mit
- Created: 2026-06-23T14:32:49.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-23T16:25:25.000Z (about 1 month ago)
- Last Synced: 2026-06-23T16:29:40.116Z (about 1 month ago)
- Topics: claude, gemini, google-antigravity, hermes, hermes-agent, hermes-plugin, oauth, plugin
- Language: Python
- Homepage:
- Size: 19.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# hermes-antigravity-auth
Google Antigravity IDE OAuth auth plugin and proxy provider for **Hermes Agent** (developed by Nous Research). This is the **official Hermes version** of the [@mrhisyammm/opencode-antigravity-auth](https://github.com/mrhisyammm/opencode-antigravity-auth) plugin!
Allows you to use Gemini 3.5 Flash, Gemini 3.1 Pro, and Claude 4.6 (Opus/Sonnet) for **FREE** inside Hermes Agent using your Google OAuth credentials pool with **isolated cooldowns** and **exponential backoff auto-rotation**!
---
## ⚡ Quick One-Line Installation
Open your terminal and run the command corresponding to your operating system to automatically download, install, and configure the plugin:
- **Windows (PowerShell - run as Administrator):**
```powershell
Set-ExecutionPolicy Bypass -Scope Process -Force; irm https://raw.githubusercontent.com/mrhisyammm/hermes-antigravity-auth/main/install.ps1 | iex
```
- **macOS / Linux:**
```bash
curl -fsSL https://raw.githubusercontent.com/mrhisyammm/hermes-antigravity-auth/main/install.sh | bash
```
---
## What You Get (Features)
- **Claude Opus 4.6, Sonnet 4.6** and **Gemini 3.5 Flash / 3.1 Pro / 3 Pro / 3 Flash** via Google OAuth
- **Self-Contained Proxy**: Runs its own lightweight proxy server locally in the background (`port 8999`), making it 100% plug-and-play without any external software dependencies.
- **Multi-Account Support**: Add multiple Google accounts; requests auto-rotate dynamically.
- **Isolated Cooldowns**: Cooldowns are tracked separately per account and model family (`claude` vs `gemini`). If Claude gets rate-limited, you can still use Gemini models on the same account!
- **Progressive Cooldowns (Exponential Backoff)**: Cooldown duration escalates based on consecutive failures (1 min → 5 mins → 30 mins → 2 hours) to avoid Google account blocks/verification checks and ensure long-term account safety.
- **Interactive TUI Manager**: Run account operations via `/antigravity-mrhisyammm` which spawns a separate terminal window to handle your logins, active account selection, and quota checks seamlessly without input hijacking.
- **Dynamic Model Mapping**: Model names are translated automatically for the target Google API (e.g., `gemini-3.5-flash` → `gemini-3.5-flash-low` in background) for seamless compatibility.
---
⚠️ Terms of Service Warning — Read Before Installing
> [!CAUTION]
> Using this plugin (and any proxy for Antigravity) violates Google's Terms of Service. A number of users have reported their Google accounts being **banned** or **shadow-banned** (restricted access without explicit notification).
>
> **By using this plugin, you acknowledge:**
> - This is an unofficial tool not endorsed by Google
> - Your account may be suspended or permanently banned
> - You assume all risks associated with using this plugin
>
---
## How to Use
### 1. Chat Commands (CLI & Desktop GUI)
The following commands work directly inside your Hermes session (both in the terminal CLI chat box and the Desktop GUI app chat window):
- **`/antigravity-mrhisyammm`**: Launches the **Google Antigravity Accounts Manager** interactive menu in a new PowerShell window. Select option `2` to log in, `1` to choose your active account, `3` to check quotas, or `4` to remove accounts.
- **`/antigravity-mrhisyammm-login`**: Directly triggers the browser login flow and sets the account active, printing the result in your chat.
- **`/antigravity-mrhisyammm-quota`**: Directly fetches and prints your live Weekly and 5-Hour limits right in your chat window.
### 2. Select Model
Run the model configuration wizard:
```bash
hermes model --refresh
```
Select **`Google Antigravity`** as your provider, and then choose any of the models (e.g. `gemini-3.5-flash`, `claude-opus-4-6-thinking`, or `claude-sonnet-4-6-thinking`).
---
## Technical Details
### Configuration Path
The plugin shares the exact same accounts file as the OpenCode version, meaning if you already logged in on OpenCode, your accounts will automatically load in Hermes:
- **Accounts Database**: `~/.config/opencode/antigravity-accounts.json` (on Windows, `~` is your home directory)
- **Fallback Directory**: `~/AppData/Local/hermes/antigravity-accounts.json` (if OpenCode is not installed on the machine, the plugin runs completely self-contained here).