loysger/Antigravity

What is this?

Antigravity Client is a downloadable desktop app (version 1.0.54) that acts as a local gateway to Google's Antigravity platform — a suite of AI coding tools that includes:

• Antigravity IDE — a code editor
• Antigravity 2.0 — an orchestrator that coordinates AI agents
• AGY CLI — a terminal-based AI agent

Google restricts these tools for users in Russia and other CIS countries, blocking access with errors like 400 Bad Request: User location is not supported. The client is built specifically to get around that restriction.

How it works

The client runs on your computer as a small local proxy at 127.0.0.1:8047. When you use Antigravity IDE, the IDE sends its traffic to this local address, and the client forwards it to a stable pool of remote servers that Google allows. This means:

• No VPN needed — only the IDE's traffic goes through the gateway; your browser, games, and other apps keep using your normal internet connection at full speed.
• No personal Google account needed — you use an access key (IMPULS-xxxxx) instead, so you avoid dealing with foreign emails, payment cards, or subscription bans.

Key features

• Runs IDE, 2.0, and CLI simultaneously through the same gateway without port conflicts.
• Fixes agent crash errors — the client actively holds WebSocket sessions open to prevent the agent terminated due to error and similar failures.
• Access to flagship AI models: Claude Sonnet 5.5, Claude Opus 5.5, Claude Sonnet 4.6, Gemini 3.1 Pro (with up to 2,000,000 token context), Gemini 3.8 Flash, and GPT-OSS 120B.
• Prompt caching — repeated requests in a conversation reuse cached context, claimed to save 3–5× on usage limits and speed up project-related answers by 40–60%.
• MCP support — can integrate third-party tools, databases, and external skills via the Model Context Protocol.
• Cross-platform — installers for Windows (EXE or MSI), macOS (Apple Silicon and Intel DMG), and Linux (DEB, AppImage, RPM).

How to use it

1. Download the installer for your OS and install the app.
2. Launch the client and enter a personal access key (format: IMPULS-xxxxx).
3. Click "Connect" and start Antigravity IDE, 2.0, or the AGY CLI.

For macOS: if Gatekeeper warns about an unknown developer on first launch, run this in Terminal:

xattr -cr "/Applications/Antigravity Client.app"

Extras

• The local gateway (127.0.0.1:8047) can also be used as an HTTP/HTTPS proxy for other AI tools like Claude Code, Cursor, or Windsurf — the README shows how to set the HTTP_PROXY / HTTPS_PROXY environment variables on Windows, macOS, and Linux.
• There's a video walkthrough on YouTube for installation and setup.
• The FAQ section links to GitHub Issues (#1–#5) with detailed explanations for each type of blocking error and how to fix it.

Getting help

• Test keys and PRO/X3/X5/ULTRA pricing — via Telegram bot @AntigravityVipbot
• Support — via Telegram @Ultimateadvansed
• Bug reports — via GitHub Issues

Important note

This is a third-party proxy service, not an official Google product. The README mentions access keys, paid tiers (PRO/X3/X5/ULTRA), and the fact that it bypasses Google's regional blocks and account requirements. The project provides no warranty or guarantee, and using it may involve risks not described in the README.