agy-proxy
Health Warn
- License — License: GPL-3.0
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Fail
- Hardcoded secret — Potential hardcoded credential in agy_proxy/auth/constants.py
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
⚡ High-performance multi-account proxy for Google Antigravity & Gemini. Exposes OpenAI & Anthropic Claude APIs for Claude Code, Cursor, Windsurf, and Aider with Web Dashboard.
⚡ Antigravity Proxy (agy-proxy)
Antigravity Proxy (agy-proxy) is a high-performance local AI gateway that supercharges the official Google Antigravity 2.0 ecosystem.
It unlocks high-tier models (Gemini 3.8 Flash, Gemini 3.1 Pro, Claude Sonnet 4.6, Claude Opus 4.6 Thinking) through standard OpenAI, Anthropic, and Google GenAI API endpoints with multi-account pooling, automated failover, token-saving context compaction, and zero-Electron RAM optimization.
🌟 Why agy-proxy?
- 🆓 Zero-Cost High-Tier AI: Access Gemini 3.8 and Claude models through Antigravity without paid API subscriptions.
- 🔄 Universal API Compatibility: Drop-in compatible with standard OpenAI (
/v1/chat/completions), Anthropic (/v1/messages), and Gemini endpoints. - 👥 Multi-Account Pool & Auto-Failover: Pool multiple Google accounts and API keys; if one hits rate limits, traffic rotates seamlessly without crashing your IDE.
- 🚀 Antigravity Web Hub (Saves RAM): Run the full Antigravity 2.0 interface directly in your browser without the heavy Electron wrapper.
- 🗜 Context Compactor (Token Saver): Auto-compresses long chat histories using fast flash-lite models, preventing Google's 1M token limit and saving 80%–95% tokens.
- 🖥️ 1-Click IDE & CLI Integrations: Native launch scripts and configurations for Antigravity IDE, Claude Code CLI, Cursor, Windsurf, VS Code (Continue, Roo Code, Cline), Codex CLI, and Aider.
⚡ Quick Start (Under 1 Minute)
1. One-Line Fast Install
Linux & macOS:
curl -fsSL https://raw.githubusercontent.com/kqlio67/agy-proxy/main/install.sh | bash
Windows (PowerShell):
irm https://raw.githubusercontent.com/kqlio67/agy-proxy/main/install.ps1 | iex
2. Run with Python / UV / Pip
# Clone the repository:
git clone https://github.com/kqlio67/agy-proxy.git
cd agy-proxy
# Run with UV (Recommended - no manual venv needed):
uv run python -m agy_proxy.cli start
# OR on Windows (1-Click Batch):
start_proxy.bat
# OR install in editable mode and run:
pip install -e .
agy-proxy start
3. Standalone Executable (Windows / Linux / macOS)
Run without needing Python or manual virtual environment setup:
- Download pre-built standalone binaries from GitHub Releases (e.g.
agy-proxy-windows-amd64.zipfor Windows). - Build locally on Windows: Double-click
build_exe.bator run:
The standalone binary will be built inpip install pyinstaller python build_binary.pydist\agy-proxy.exe.
4. Open the Web Dashboard
Open http://127.0.0.1:8000 in your browser to:
- Connect Google accounts via 1-click OAuth (PKCE) or add AI Studio API keys.
- View real-time quotas, token analytics, and request metrics.
- Configure context compactor thresholds and proxy tunneling.
🎯 Quick Launch Helpers (The 3 Main Workflows)
agy-proxy comes with dedicated, ready-to-run helpers for the most popular workflows:
1. 🚀 Antigravity Web Hub (Zero Electron)
Run Google Antigravity 2.0 in your browser, saving RAM (works even on headless VPS servers):
# Standard Web Hub (RAM freed, no Electron):
agy-proxy web
# Patched Web Hub (Unlocks Web Terminal, File Explorer, Battle Mode):
agy-proxy web --patched
# Open browser explicitly (-o) and clean up Electron (-k):
agy-proxy web --patched -k -o
# Headless server setup (download official binary without Electron):
agy-proxy web --download-server
👉 Detailed guide: Antigravity Web Mode & Patched Hub
2. 🤖 Claude Code CLI (Proxy or Direct Vanilla)
Run Anthropic's official Claude Code CLI with 1M Gemini context or directly with official Anthropic API:
# Launch with Gemini 1M context via proxy:
agy-proxy claude
# Launch directly with official Anthropic API (debloated, zero telemetry):
agy-proxy claude --direct
# Patch binary to remove prompt restrictions and debloat tips:
agy-proxy patch-claude apply
# Autonomous execution with selective MCP tools:
agy-proxy claude --danger --mcp rea
👉 Detailed guide: Claude Code CLI Integration & Patcher
3. ⌨️ OpenAI Codex CLI
Run OpenAI Codex CLI with full Antigravity model catalog:
# Launch interactive session:
agy-proxy codex
# Launch with specific model:
agy-proxy codex -m claude-sonnet-4-6
👉 Detailed guide: OpenAI Codex CLI Integration
4. 💻 Google Antigravity CLI (agy v1.5.5) & ACP Server
Run the official Google Antigravity CLI coding agent or start the ACP stdio server for Zed & Neovim:
# Autonomous mode with proxy routing:
agy-proxy agy --mode auto
# Specific account with maximum reasoning effort and auto-approved tools:
agy-proxy agy -a [email protected] --mode auto --effort max --danger
# Start Agent Client Protocol (ACP) stdio server for Zed / Neovim:
agy-proxy acp --danger
👉 Detailed guide: Antigravity CLI & ACP Stdio Server Guide
5. 🖥️ Antigravity IDE (Zero-Patch & SQLite Sync)
Route Antigravity IDE through agy-proxy without modifying binaries or sync pool tokens directly to IDE SQLite DB:
# Zero-Patch mode (routes via settings.json without binary modifications):
agy-proxy patch ide-settings --apply
# Switch account and sync directly into IDE SQLite DB (state.vscdb):
agy-proxy switch "[email protected]" --sync-ide-db
# Check current patch status:
agy-proxy patch status
# Binary patch with live health watchdog (optional fallback):
agy-proxy patch install -y
👉 Detailed guide: Antigravity IDE Integration Guide
📚 Complete Documentation Index
All in-depth technical guides, configuration references, and tutorials are organized inside the docs/ directory:
| Section | Topic | Description |
|---|---|---|
| 💻 | Antigravity CLI & ACP Guide | Official agy v1.5.5 runner, ACP stdio server for Zed & Neovim, autonomous execution. |
| 🖥️ | Antigravity IDE Integration | Zero-Patch mode, SQLite Protobuf state sync, Dual OAuth, and binary patcher. |
| 🚀 | Web Mode & Patched Hub | No-Electron optimization, unlocked Web Terminal, File Explorer, Battle Mode. |
| 🤖 | Claude Code CLI Guide | 1-click runner, direct vanilla mode, binary patcher, selective MCP, and debloater. |
| ⌨️ | OpenAI Codex CLI Guide | Interactive model launcher and ~/.codex/config.toml setup. |
| 💻 | IDEs & Coding Agents | Cursor, Windsurf, VS Code (Continue, Roo Code, Cline), Aider, and OpenCode. |
| 👥 | Multi-Account Pool & Failover | OAuth PKCE login, API keys, quota balancing, session switching, and proxy tunneling. |
| 🗜 | Context Compactor (Token Saver) | Automated long-context summarization and Google 1M token limit prevention. |
| 🧪 | Experimental Flags Manager | Curated developer feature toggles and protection against broken internal flags. |
| 🌐 | Cloudflare Edge & Remote Access | Serverless 24/7 edge worker, regional Geo-Bypass, and cloudflared HTTPS tunnel. |
| ⚙️ | Deployment & System Services | Docker, Docker Compose, Linux systemd daemon, macOS launchd, and Android Termux. |
| 💻 | SDKs, REST API & Env Reference | Python OpenAI / Anthropic / Google GenAI SDK examples and configuration reference. |
🤖 Supported Models & Aliases
Configure your clients using any of these supported model identifiers:
| Model ID | Provider Family | Context Window | Best For |
|---|---|---|---|
gemini-4-carbon / carbon |
Gemini 4 Carbon | 1,048,576 tokens | Google Next-Gen v2.31.0 CloudCode model with deep reasoning. |
gemini-4-argon / gemini-4-argon-high |
Gemini 4 Argon | 1,048,576 tokens | Next-gen flagship reasoning model (auto-unlocked). |
gemini-3.8-flash-high |
Gemini 3.8 | 1,048,576 tokens | Ultra-fast coding, agentic workflows, low latency. |
gemini-3.8-flash-deepagent |
Gemini 3.8 | 1,048,576 tokens | Autonomous multi-agent coding preset with high reasoning effort. |
gemini-3.1-pro-high |
Gemini 3.1 | 1,048,576 tokens | Large refactors, high-precision architecture design. |
claude-sonnet-4-6 |
Claude 3.5/3.7/4.6 | 200,000 tokens | Top-tier code synthesis, Cursor & Claude Code. |
claude-sonnet-4-6-deepagent |
Claude 4.6 | 200,000 tokens | Autonomous agent preset with 64k extended thinking budget. |
claude-opus-4-6-thinking |
Claude 4.6 | 200,000 tokens | Deep extended thinking, mathematically rigorous proofs. |
claude-opus-4-6-deepagent |
Claude 4.6 | 200,000 tokens | Maximum capability autonomous agent with 64k thinking budget. |
gemini-3.1-flash-image |
Gemini 3.1 | 65,536 tokens | Image generation & multi-image edits (/v1/images/*). |
gpt-4o (alias) |
OpenAI Mapping | Maps to Flash High | Drop-in replacement for OpenAI-default tools. |
⌨️ Common CLI Cheat Sheet
# Start proxy server on default port 8000:
agy-proxy start
# Start Antigravity in browser Web mode:
agy-proxy web
# Add a Google account via browser OAuth:
agy-proxy login
# List pooled accounts and current quota levels:
agy-proxy accounts
# Switch active Antigravity session to best available account:
agy-proxy switch --best
# List and toggle experimental features:
agy-proxy flags
# Self-update to latest release:
agy-proxy update
⚠️ Disclaimer & Terms of Service Notice
This project is an independent open-source tool developed for developer productivity, resource optimization, and educational research. It is not affiliated with, endorsed by, or sponsored by Google LLC or Anthropic PBC.
Users are solely responsible for ensuring their usage complies with Google and Anthropic applicable Terms of Service and API usage guidelines.
📄 License
Distributed under the MIT License. See LICENSE for full details.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found