Quick Start Guide

This guide will walk you through the essential steps to get Antigravity Manager up and running, from adding your first account to making your first successful API call.

Prerequisites

Before you begin, ensure you have:

Antigravity Manager Installed

Follow the Installation Guide if you haven’t installed it yet

Google Account

A Google account with access to Gemini API or Google One AI Premium

Step 1: Launch Antigravity Manager

Start the Application

Desktop: Launch “Antigravity Tools” from your application menu
Docker: Navigate to http://localhost:8045 in your browser

Set Your API Key

Go to API Proxy → Settings and set your preferred API key. This key will be used to authenticate all API requests.

# Example API key format
sk-antigravity

Remember this key - you’ll need it for all API calls!

Start the Proxy Service

In the API Proxy tab, click the toggle to start the local proxy server. The default address is:

http://127.0.0.1:8045

Step 2: Add Your First Account

Antigravity Manager supports multiple methods for adding accounts. OAuth 2.0 is recommended for the best experience.

OAuth 2.0 Authorization (Recommended)

Navigate to Accounts

Click on Accounts in the sidebar, then click Add Account → OAuth

Copy Authorization URL

The dialog will pre-generate an authorization URL. Click the link to copy it to your clipboard.

The authorization URL contains a one-time local callback port. Always use the latest URL shown in the dialog.

Complete Authorization

Open the copied URL in your preferred browser
Sign in with your Google account
Grant the requested permissions
Wait for the browser to show ”✅ Authorized successfully!”

Finalize in Antigravity

The application should automatically detect the authorization and save your account. If not, click “I already authorized, continue” to finish manually.

If the application isn’t running or the dialog is closed during authorization, the browser may show localhost refused connection. Simply restart the OAuth flow from Step 1.

Alternative: Token Import

If you already have tokens from another tool:

Single Token
Batch JSON Import

Click Add Account → Token
Paste your token
Click Save

Step 3: Verify Account Status

After adding your account:

Check Account List

Your account should appear in the Accounts page with:

✅ Active status
Current quota percentage for each model
Last synchronization time

View Dashboard

Navigate to Dashboard to see:

Average remaining quota across all accounts
Best account recommendations
Active account snapshot

Refresh Quota

Click Refresh next to your account to sync the latest quota information from Google.

Antigravity Manager automatically detects and marks accounts with 403 Forbidden status, skipping them in routing.

Step 4: Make Your First API Call

Now that your account is configured, let’s make your first API call. Choose your preferred integration method:

Using Python

The most straightforward way to test the integration:

import openai

client = openai.OpenAI(
    api_key="sk-antigravity",  # Your API key from Step 1
    base_url="http://127.0.0.1:8045/v1"
)

response = client.chat.completions.create(
    model="gemini-3-flash",
    messages=[{"role": "user", "content": "Hello, please introduce yourself"}]
)

print(response.choices[0].message.content)

import openai
import base64

client = openai.OpenAI(
    api_key="sk-antigravity",
    base_url="http://127.0.0.1:8045/v1"
)

# Generate image
response = client.images.generate(
    model="gemini-3-pro-image",
    prompt="A futuristic cyberpunk city with neon lights",
    size="1920x1080",      # Supports any WIDTHxHEIGHT format
    quality="hd",          # "standard" | "hd" | "medium"
    n=1,
    response_format="b64_json"
)

# Save image
image_data = base64.b64decode(response.data[0].b64_json)
with open("output.png", "wb") as f:
    f.write(image_data)

import openai

client = openai.OpenAI(
    api_key="sk-antigravity",
    base_url="http://127.0.0.1:8045/v1"
)

stream = client.chat.completions.create(
    model="gemini-3-flash",
    messages=[{"role": "user", "content": "Tell me a story"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Using Claude Code CLI

Integrate with the official Claude Code command-line interface:

Set Environment Variables

export ANTHROPIC_API_KEY="sk-antigravity"
export ANTHROPIC_BASE_URL="http://127.0.0.1:8045"

Run Claude

claude

You should now be able to interact with Claude through Antigravity Manager’s proxy.

Using OpenCode

Antigravity Manager includes built-in OpenCode synchronization:

Navigate to OpenCode Sync

Go to API Proxy → External Providers → OpenCode Sync

Click Sync Button

This automatically generates ~/.config/opencode/opencode.json with:

Dedicated provider antigravity-manager (doesn’t overwrite google/anthropic)
Optional: Check Sync accounts to export account data

Test the Integration

# Test antigravity-manager provider (supports --variant)
opencode run "test" --model antigravity-manager/claude-sonnet-4-5-thinking --variant high

# If opencode-antigravity-auth is installed, google provider still works independently
opencode run "test" --model google/antigravity-claude-sonnet-4-5-thinking --variant max

Windows Users: The config path is C:\Users\<User>\.config\opencode\ following the same ~/.config/opencode convention.

Using cURL

Test the API directly with HTTP requests:

curl -X POST http://127.0.0.1:8045/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-antigravity" \
  -d '{
    "model": "gemini-3-flash",
    "messages": [
      {"role": "user", "content": "What is the capital of France?"}
    ]
  }'

curl -X POST http://127.0.0.1:8045/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-antigravity" \
  -d '{
    "model": "gemini-3-flash",
    "messages": [
      {"role": "user", "content": "Hello, Claude!"}
    ]
  }'

curl -X POST http://127.0.0.1:8045/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-antigravity" \
  -d '{
    "model": "gemini-3-pro-image",
    "prompt": "A cute cat",
    "size": "1280x720",
    "quality": "hd",
    "n": 1
  }'

Understanding Model Names

Antigravity Manager provides flexible model naming for different use cases:

Available Models

Chat Models
Image Models

Model Name	Description	Use Case
`gemini-3-flash`	Fast, efficient model	Quick queries, high-volume
`gemini-3-pro-high`	Advanced reasoning	Complex tasks
`gemini-3.1-pro`	Latest Gemini Pro	Production workloads
`claude-sonnet-4-6`	Claude 4.6 Sonnet	Balanced performance
`claude-sonnet-4-6-thinking`	With thinking mode	Complex reasoning
`claude-opus-4-6-thinking`	Most capable model	Advanced tasks

Model Name	Description
`gemini-3-pro-image`	Standard image generation
`gemini-3.1-flash-image`	Fast image generation
`gemini-3-pro-image-16-9-4k`	16:9 aspect ratio, 4K quality
`gemini-3-pro-image-1-1-2k`	Square, 2K quality

Model Routing

You can configure custom model mappings in Model Router:

Navigate to Model Router in the sidebar
Click Add Mapping
Set source model pattern (regex supported)
Set target model
Save and test

Use regex patterns like gpt-4.* to route all GPT-4 requests to gemini-3-pro-high

Advanced Features

Smart Account Switching

Antigravity Manager automatically selects the best account based on:

Current quota availability
Account tier (Ultra/Pro/Free)
Reset frequency
403 forbidden status

View recommendations in the Dashboard → Best Account section.

Image Generation Parameters

string

Aspect ratio or resolution. Supports:

Specific dimensions: 1920x1080, 1024x1024, 1280x720
Aspect ratios: 16:9, 9:16, 4:3, 3:4, 1:1, 21:9

System automatically maps to standard ratios.

string

default:"standard"

Image quality level:

"hd" → 4K resolution
"medium" → 2K resolution
"standard" → Default resolution

string

Direct Gemini resolution specification (highest priority):

"4K" - 4K resolution
"2K" - 2K resolution
"1K" - Standard resolution

Overrides quality parameter if both are set.

Quota Protection

Enable quota protection to prevent account exhaustion:

Go to Settings → Quota Protection
Enable the toggle
Set minimum quota threshold (e.g., 10%)
Antigravity will skip accounts below the threshold

Background Tasks

Configure automatic account maintenance:

Auto Refresh

Automatically sync account quotas at regular intervals:

Settings → Background Auto Refresh
Set interval (in minutes, max 35791)
Recommended: 15-30 minutes

Smart Warmup

Keep accounts active with periodic requests (currently disabled by default in v4.1.24+):

Manual warmup still available in Account Management
To re-enable: modify source code and rebuild

Integration Examples

Cherry Studio

Open Cherry Studio settings
Add a new OpenAI provider:
- Base URL: http://127.0.0.1:8045/v1
- API Key: sk-antigravity
Configure model settings:
- Model: gemini-3-pro-image (for images)
- Size: 1920x1080
- Quality: hd

Kilo Code

Use Gemini protocol with Kilo Code. OpenAI mode produces non-standard paths (/v1/chat/completions/responses) that return 404.

Open Kilo Code settings
Select Gemini as protocol
Set Base URL: http://127.0.0.1:8045
Set API Key: sk-antigravity
Configure model mappings if needed

Troubleshooting

Connection refused to http://127.0.0.1:8045

Check if proxy service is running:

Open Antigravity Manager
Navigate to API Proxy
Ensure the toggle is ON (green)

Verify port isn’t blocked:

curl http://127.0.0.1:8045/health

API returns "Invalid API key"

Verify your API key matches:

Check API Proxy → Settings for the configured key
Ensure your requests use the same key in headers:
- OpenAI format: Authorization: Bearer sk-antigravity
- Anthropic format: x-api-key: sk-antigravity

Account shows "403 Forbidden"

Possible causes:

Verification required: Check error details for verification link
Plan ineligibility: Verify your Google account has Gemini access
Rate limiting: Wait and try refreshing quota later

Solution:

Click on the account to view error details
Follow any verification links provided
Some 403 errors resolve automatically after waiting

Quota shows 0% but account has quota

Refresh the quota manually:

Go to Accounts
Click Refresh next to the account
Wait for synchronization to complete

Enable auto-refresh:

Settings → Background Auto Refresh
Set interval to 15-30 minutes

Image generation returns "No accounts available"

Check image model quota:

Verify accounts have gemini-3-pro-image or gemini-3.1-flash-image quota
Dashboard should show non-zero “Gemini Image” average quota
Refresh account quotas if needed

Common issue (fixed in v4.1.27):

Ensure using v4.1.27+ which includes gemini-3.1-flash-image support
Earlier versions only recognized gemini-3-pro-image

Next Steps

Explore Model Router

Set up custom model mappings and routing rules for advanced workflows

Configure Docker

Deploy Antigravity Manager on your NAS or server for 24/7 availability

Join Community

Get help, share tips, and stay updated on new features

GitHub Repository

Report issues, request features, and contribute to the project

Common Use Cases

Multi-Account Load Balancing

Add multiple Google accounts to:

Increase total quota pool
Automatic failover when one account is rate-limited
Smart routing based on quota availability

Antigravity Manager handles rotation automatically.

Development & Testing

Use Antigravity Manager as a local proxy for:

Testing AI integrations without cloud dependencies
Rapid prototyping with multiple model types
Cost-effective development with Gemini’s free tier

Team Collaboration

Deploy with Docker and share:

API_KEY with team members for AI requests
WEB_PASSWORD with admins only for account management
Centralized quota monitoring and account health

You’re all set! You now have Antigravity Manager configured and ready to proxy AI requests. Experiment with different models, set up custom routing, and explore advanced features.

Getting Started

Core Features

Integration Guides

Configuration

Deployment

Troubleshooting

Quick Start Guide

Quick Start Guide

Prerequisites

Antigravity Manager Installed

Google Account

Step 1: Launch Antigravity Manager

Step 2: Add Your First Account

OAuth 2.0 Authorization (Recommended)

Alternative: Token Import

Step 3: Verify Account Status

Step 4: Make Your First API Call

Using Python

Using Claude Code CLI

Using OpenCode

Using cURL

Understanding Model Names

Available Models

Model Routing

Advanced Features

Smart Account Switching

Image Generation Parameters

Quota Protection

Background Tasks

Integration Examples

Cherry Studio

Kilo Code

Troubleshooting

Next Steps

Explore Model Router

Configure Docker

Join Community

GitHub Repository

Common Use Cases

​Quick Start Guide

​Prerequisites

Antigravity Manager Installed

Google Account

​Step 1: Launch Antigravity Manager

​Step 2: Add Your First Account

​OAuth 2.0 Authorization (Recommended)

​Alternative: Token Import

​Step 3: Verify Account Status

​Step 4: Make Your First API Call

​Using Python

​Using Claude Code CLI

​Using OpenCode

​Using cURL

​Understanding Model Names

​Available Models

​Model Routing

​Advanced Features

​Smart Account Switching

​Image Generation Parameters

​Quota Protection

​Background Tasks

​Integration Examples

​Cherry Studio

​Kilo Code

​Troubleshooting

​Next Steps

Explore Model Router

Configure Docker

Join Community

GitHub Repository

​Common Use Cases

Quick Start Guide

Prerequisites

Step 1: Launch Antigravity Manager

Step 2: Add Your First Account

OAuth 2.0 Authorization (Recommended)

Alternative: Token Import

Step 3: Verify Account Status

Step 4: Make Your First API Call

Using Python

Using Claude Code CLI

Using OpenCode

Using cURL

Understanding Model Names

Available Models

Model Routing

Advanced Features

Smart Account Switching

Image Generation Parameters

Quota Protection

Background Tasks

Integration Examples

Cherry Studio

Kilo Code

Troubleshooting

Next Steps

Common Use Cases