antigravity-manager
Antigravity Manager
Skill by ara.so — Daily 2026 Skills collection.
Antigravity Manager is a professional AI account manager and proxy gateway. It takes Google (Gemini) and Anthropic (Claude) web session tokens and exposes them as standard API endpoints (OpenAI-compatible, Anthropic-native, and Gemini-native formats) with intelligent multi-account rotation, quota tracking, and automatic failover.
Key capabilities:
- Multi-account management with real-time quota dashboards
- Protocol conversion: web sessions → OpenAI / Anthropic / Gemini API
- Auto-rotation on 429/401 errors (millisecond failover)
- Model routing and remapping
- Desktop app (Tauri v2 + React + Rust) or headless Docker/server mode
Installation
Option A: One-line script (Linux/macOS)
curl -fsSL https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/v4.1.30/install.sh | bash
Install a specific version:
curl -fsSL https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/v4.1.30/install.sh | bash -s -- --version 4.1.30
Dry run (preview without installing):
curl -fsSL https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/v4.1.30/install.sh | bash -s -- --dry-run
Option B: Windows (PowerShell)
irm https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/main/install.ps1 | iex
Option C: Homebrew (macOS / Linuxbrew)
brew tap lbjlaq/antigravity-manager https://github.com/lbjlaq/Antigravity-Manager
brew install --cask antigravity-tools
Option D: Docker (recommended for servers/NAS)
docker run -d --name antigravity-manager \
-p 8045:8045 \
-e API_KEY=$ANTIGRAVITY_API_KEY \
-e WEB_PASSWORD=$ANTIGRAVITY_WEB_PASSWORD \
-e ABV_MAX_BODY_SIZE=104857600 \
-v ~/.antigravity_tools:/root/.antigravity_tools \
lbjlaq/antigravity-manager:latest
Docker Compose:
# docker-compose.yml
version: "3.8"
services:
antigravity:
image: lbjlaq/antigravity-manager:latest
container_name: antigravity-manager
restart: unless-stopped
ports:
- "8045:8045"
environment:
- API_KEY=${ANTIGRAVITY_API_KEY}
- WEB_PASSWORD=${ANTIGRAVITY_WEB_PASSWORD}
- ABV_MAX_BODY_SIZE=104857600
volumes:
- ~/.antigravity_tools:/root/.antigravity_tools
docker compose up -d
docker logs antigravity-manager # view logs / recover forgotten keys
Option E: Manual download
Download from GitHub Releases:
- macOS:
.dmg(Apple Silicon + Intel) - Windows:
.msior portable.zip - Linux:
.deb,.rpm, or.AppImage
Authentication / Security Model
Antigravity uses two separate credentials:
| Credential | Env var | Config key | Purpose |
|---|---|---|---|
| API Key | API_KEY |
api_key |
Authenticates AI API calls (Authorization: Bearer ...) |
| Web Password | WEB_PASSWORD |
admin_password |
Logs into the management web UI |
Scenario A — only API_KEY set:
- Web UI login: use
API_KEY - API calls: use
API_KEY
Scenario B — both set (recommended):
- Web UI login:
WEB_PASSWORDonly (API Key rejected for login) - API calls:
API_KEYonly
Recover credentials:
docker logs antigravity-manager
# or
grep -E '"api_key"|"admin_password"' ~/.antigravity_tools/gui_config.json
API Endpoints
The proxy server runs on port 8045 by default.
OpenAI-compatible (works with any OpenAI SDK)
POST http://localhost:8045/v1/chat/completions
Authorization: Bearer $ANTIGRAVITY_API_KEY
Anthropic-native (Claude Code, etc.)
POST http://localhost:8045/v1/messages
Authorization: Bearer $ANTIGRAVITY_API_KEY
Gemini-native
POST http://localhost:8045/v1/models/{model}:generateContent
Authorization: Bearer $ANTIGRAVITY_API_KEY
Code Examples
Python — OpenAI SDK (Gemini via Antigravity)
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ANTIGRAVITY_API_KEY"],
base_url="http://localhost:8045/v1",
)
response = client.chat.completions.create(
model="gemini-2.5-pro",
messages=[
{"role": "user", "content": "Explain quantum entanglement in simple terms."}
],
stream=True,
)
for chunk in response:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
Python — Anthropic SDK (Claude via Antigravity)
import os
import anthropic
client = anthropic.Anthropic(
api_key=os.environ["ANTIGRAVITY_API_KEY"],
base_url="http://localhost:8045",
)
message = client.messages.create(
model="claude-sonnet-4-5",
max_tokens=1024,
messages=[
{"role": "user", "content": "Write a haiku about distributed systems."}
],
)
print(message.content[0].text)
Python — Streaming with Anthropic
import os
import anthropic
client = anthropic.Anthropic(
api_key=os.environ["ANTIGRAVITY_API_KEY"],
base_url="http://localhost:8045",
)
with client.messages.stream(
model="claude-opus-4-5",
max_tokens=2048,
system="You are a helpful coding assistant.",
messages=[{"role": "user", "content": "Implement a binary search in Rust."}],
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)
TypeScript / Node — OpenAI SDK
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.ANTIGRAVITY_API_KEY!,
baseURL: "http://localhost:8045/v1",
});
async function chat(prompt: string): Promise<string> {
const response = await client.chat.completions.create({
model: "gemini-2.5-flash",
messages: [{ role: "user", content: prompt }],
});
return response.choices[0].message.content ?? "";
}
// Image generation via Imagen 3
async function generateImage(prompt: string) {
const response = await client.images.generate({
model: "imagen-3.0-generate-002",
prompt,
size: "1024x1024", // maps to Imagen 3 aspect ratio
n: 1,
});
return response.data[0].url;
}
cURL — quick test
# Test OpenAI-compatible endpoint
curl -s http://localhost:8045/v1/chat/completions \
-H "Authorization: Bearer $ANTIGRAVITY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-2.5-pro",
"messages": [{"role": "user", "content": "Hello!"}]
}' | jq '.choices[0].message.content'
# Test Anthropic endpoint
curl -s http://localhost:8045/v1/messages \
-H "Authorization: Bearer $ANTIGRAVITY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-5",
"max_tokens": 256,
"messages": [{"role": "user", "content": "Hello!"}]
}' | jq '.content[0].text'
Connecting Claude Code CLI
Claude Code uses the Anthropic protocol. Point it at Antigravity:
# Set environment variables before starting Claude Code
export ANTHROPIC_API_KEY=$ANTIGRAVITY_API_KEY
export ANTHROPIC_BASE_URL=http://localhost:8045
claude # start Claude Code — it will use Antigravity as the backend
Or create a .env in your project root:
# .env
ANTHROPIC_API_KEY=your-antigravity-api-key
ANTHROPIC_BASE_URL=http://localhost:8045
Connecting to Popular AI Clients
Cherry Studio
- Open Cherry Studio → Settings → API Provider
- Select OpenAI-compatible
- Base URL:
http://localhost:8045/v1 - API Key: your
ANTIGRAVITY_API_KEY
Cursor
In Cursor settings, set:
- OpenAI Base URL:
http://localhost:8045/v1 - API Key: your
ANTIGRAVITY_API_KEY
Continue.dev
// ~/.continue/config.json
{
"models": [
{
"title": "Gemini Pro (Antigravity)",
"provider": "openai",
"model": "gemini-2.5-pro",
"apiKey": "YOUR_ANTIGRAVITY_API_KEY",
"apiBase": "http://localhost:8045/v1"
},
{
"title": "Claude (Antigravity)",
"provider": "anthropic",
"model": "claude-sonnet-4-5",
"apiKey": "YOUR_ANTIGRAVITY_API_KEY",
"apiBase": "http://localhost:8045"
}
]
}
Configuration File
Config is stored at ~/.antigravity_tools/gui_config.json:
{
"api_key": "sk-your-api-key",
"admin_password": "your-web-ui-password",
"proxy": {
"port": 8045,
"max_body_size": 104857600,
"admin_password": "your-web-ui-password"
},
"model_routes": [
{
"pattern": "gpt-4.*",
"target": "gemini-2.5-pro"
},
{
"pattern": "gpt-3.5.*",
"target": "gemini-2.5-flash"
}
]
}
Environment Variables (Docker / server mode)
| Variable | Description | Default |
|---|---|---|
API_KEY |
API key for authenticating proxy requests | required |
WEB_PASSWORD |
Web UI admin password | falls back to API_KEY |
ABV_MAX_BODY_SIZE |
Max request body in bytes (for image uploads) | 104857600 (100MB) |
Model Routing
Antigravity's model router lets you remap incoming model names to actual upstream models. This is useful when clients hard-code model names like gpt-4.
Configuration via Web UI (API Proxy → Model Router) or gui_config.json:
{
"model_routes": [
{
"pattern": "gpt-4-turbo",
"target": "gemini-2.5-pro"
},
{
"pattern": "gpt-4o",
"target": "gemini-2.5-pro"
},
{
"pattern": "gpt-3\\.5.*",
"target": "gemini-2.5-flash"
},
{
"pattern": "claude-3-opus.*",
"target": "claude-opus-4-5"
}
]
}
Tiered routing (automatic): Antigravity prioritizes accounts by type (Ultra → Pro → Free) and quota reset frequency, consuming fast-reset accounts first.
Background task demotion (automatic): Requests detected as background tasks (e.g., Claude CLI title generation) are automatically redirected to Flash-tier models to preserve premium quota.
Account Management
Adding accounts via the UI
- Open Antigravity Manager desktop app or web UI (
http://localhost:8045) - Navigate to Accounts
- Click Add Account — the app generates an OAuth 2.0 authorization URL
- Complete authorization in any browser
- The app captures the callback automatically; click "I've authorized, continue" if needed
Batch import (JSON)
Export from another tool and import in the Accounts page:
[
{
"token": "session-token-1",
"type": "google",
"label": "account-work"
},
{
"token": "session-token-2",
"type": "anthropic",
"label": "account-personal"
}
]
Migration from v1
Antigravity auto-detects and migrates v1 database format on first launch — no manual steps needed.
Quota Monitoring
The dashboard shows live quota across all accounts:
- Gemini Pro remaining calls (average across accounts)
- Gemini Flash remaining calls
- Claude remaining calls
- Imagen 3 image generation quota
Smart Recommendation: The dashboard algorithmically selects the account with the most headroom and offers one-click switching.
403 detection: Accounts banned upstream are automatically flagged and skipped during rotation.
Building from Source (Rust + Tauri v2)
Prerequisites
# Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
# Node.js (for frontend)
node --version # requires v18+
# Tauri v2 CLI
cargo install tauri-cli --version "^2"
# System deps (Linux)
sudo apt install libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev
Build & run
git clone https://github.com/lbjlaq/Antigravity-Manager.git
cd Antigravity-Manager
npm install # install frontend deps
cargo tauri dev # run in development mode
cargo tauri build # build release binaries → src-tauri/target/release/bundle/
Build headless server only (no GUI)
cd src-tauri
cargo build --release --features headless
./target/release/antigravity-manager --headless --port 8045
Troubleshooting
Port 8045 already in use
# Find and kill the process
lsof -ti:8045 | xargs kill -9
# or change port in gui_config.json:
# "proxy": { "port": 8046 }
Forgotten API key or web password
# Docker
docker logs antigravity-manager | grep -E "api_key|password"
# Local install
cat ~/.antigravity_tools/gui_config.json | grep -E '"api_key"|"admin_password"'
Account shows 403 / banned
The account has been flagged upstream. In the Accounts view it will be marked with a 403 badge and automatically skipped. Add a fresh account and remove/re-authorize the banned one.
Requests failing with 429
Antigravity handles this automatically (rotates to next account within milliseconds). If all accounts are exhausted, add more accounts or wait for quota reset. Check the dashboard for per-account quota status.
macOS Gatekeeper blocking the app
xattr -d com.apple.quarantine /Applications/Antigravity\ Tools.app
# or install with:
brew install --cask antigravity-tools --no-quarantine
Docker container not persisting accounts after restart
Ensure the volume mount is correct:
docker run ... -v ~/.antigravity_tools:/root/.antigravity_tools ...
# Verify data is present:
ls ~/.antigravity_tools/
Claude Code not connecting
# Verify the proxy is running
curl -s http://localhost:8045/v1/models \
-H "Authorization: Bearer $ANTIGRAVITY_API_KEY"
# Check env vars are exported (not just set)
export ANTHROPIC_BASE_URL=http://localhost:8045
export ANTHROPIC_API_KEY=$ANTIGRAVITY_API_KEY
echo $ANTHROPIC_BASE_URL # should print the URL
Project Structure (for contributors)
Antigravity-Manager/
├── src/ # React frontend (TypeScript)
│ ├── components/ # UI components (Dashboard, Accounts, etc.)
│ └── pages/
├── src-tauri/ # Rust backend
│ ├── src/
│ │ ├── main.rs # Tauri app entry
│ │ ├── proxy/ # Axum HTTP proxy server
│ │ │ ├── router.rs # Model routing logic
│ │ │ ├── dispatcher.rs # Account rotation
│ │ │ └── mapper.rs # Protocol conversion
│ │ ├── accounts/ # Account storage & OAuth
│ │ └── quota/ # Quota tracking
│ └── Cargo.toml
├── docker/
│ └── Dockerfile
├── install.sh # Linux/macOS installer
├── install.ps1 # Windows installer
└── docker-compose.yml