====== Antigravity-Manager ======

===== What is Antigravity-Manager? =====

**Antigravity-Manager** is a desktop application designed to **manage and switch between multiple AI accounts** (multi-account manager & switcher) for the **Antigravity Tools** ecosystem.

It allows users to:
  * Store multiple AI accounts (API keys or tokens)
  * Switch accounts with one click
  * Avoid repeated manual login and logout
  * Work efficiently with different AI services

**Vocabulary notes:**
  * **Desktop application** /ˈdesktɒp ˌæplɪˈkeɪʃən/: ứng dụng máy tính
  * **Multi-account** /ˌmʌlti əˈkaʊnt/: nhiều tài khoản
  * **Ecosystem** /ˈiːkəʊˌsɪstəm/: hệ sinh thái


===== Key Features =====

  * Manage multiple AI accounts in one place
  * Fast and seamless account switching
  * Simple and user-friendly interface
  * Cross-platform support (Windows, macOS, Linux)
  * Suitable for development, testing, and production environments

**Vocabulary notes:**
  * **Seamless** /ˈsiːmləs/: mượt mà, không gián đoạn
  * **Interface** /ˈɪntəfeɪs/: giao diện
  * **Cross-platform** /ˌkrɒs ˈplætfɔːm/: đa nền tảng
  * **Production** /prəˈdʌkʃən/: môi trường chạy thật


===== Technology Stack =====

Antigravity-Manager is built with modern technologies:

  * **Tauri v2** – lightweight desktop application framework
  * **React** – frontend user interface
  * **Rust** – backend logic with high performance

**Vocabulary notes:**
  * **Framework** /ˈfreɪmwɜːrk/: bộ khung phát triển
  * **Frontend** /ˈfrʌntend/: giao diện người dùng
  * **Backend** /ˈbækend/: xử lý phía sau
  * **Performance** /pəˈfɔːməns/: hiệu năng


===== System Requirements =====

  * Node.js >= 18
  * Rust >= 1.70
  * npm or pnpm
  * Git

**Vocabulary notes:**
  * **Requirement** /rɪˈkwaɪəmənt/: yêu cầu
  * **Runtime** /ˈrʌntaɪm/: môi trường chạy


===== Installation Guide =====


=== 1. Install Rust on macOS or Linux ===

Step 1: Open Terminal

Step 2: Run this command

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Step 3: Follow the instructions

Press 1 (default installation)

Wait until installation finishes

Step 4: Restart terminal (or run)

source $HOME/.cargo/env

rustc --version

=== 2. Install Antigravity Tools ===

brew tap lbjlaq/antigravity-manager https://github.com/lbjlaq/Antigravity-Manager

brew install --cask antigravity-tools

=== 3. Open Antigravity Tools ===

Go to Applications

Open Antigravity Tools

===== Usage Guide =====

2. What Antigravity Tools Actually Does (Quick Mental Model)

Think of it as:

A local AI gateway + account manager

It:

Runs a local server on your machine

Manages multiple AI accounts

Exposes them as standard APIs (OpenAI / Anthropic compatible)

3. Initial Setup (Required)
Step 1: Open Web UI

By default, Antigravity Tools starts a local server.

Open your browser and go to:

http://127.0.0.1:8045

127.0.0.1 /ˌwʌn tuː ˈsɛvən ˈzɪərəʊ/
→ localhost (your own computer)

Step 2: Login

Depending on how you installed it:

Default password: shown in the app UI

Or you may need to set one in Settings

If you set:

API_KEY → used for API access

WEB_PASSWORD → used for web login

4. Add AI Accounts
Go to: Accounts → Add Account

You can add accounts in several ways:

Option A: OAuth Login (Recommended)

Google (Gemini)

Anthropic (Claude)

Just click Authorize, log in, done.

OAuth /ˈoʊæθ/
→ a secure login method without sharing passwords

Option B: Token / Cookie Import

Paste session token

Import JSON

Batch import (advanced users)

5. Check Account Status (Very Important)

Go to Dashboard

You will see:

Account health

Remaining quota

Last sync time

🟢 Green = usable
🟡 Yellow = low quota
🔴 Red = blocked / expired

6. Use It as an API (Most Common Use)
OpenAI-compatible API

Base URL:

http://127.0.0.1:8045/v1

API Key:

your API_KEY

Example with curl:

curl http://127.0.0.1:8045/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4",
    "messages": [
      { "role": "user", "content": "Hello!" }
    ]
  }'

You can now plug this into:

OpenAI SDKs

LangChain

LlamaIndex

Cursor / Continue / Claude Code (via Anthropic endpoint)

7. Model Routing (Optional but Powerful)

Go to Models / Routing

You can:

Map gpt-4 → gemini-pro

Map claude-3-opus → gemini-ultra

Create fallback chains

Routing /ˈruːtɪŋ/
→ automatically choosing where requests go

8. Auto-Failover (Set Once, Forget)

Antigravity Tools will:

Retry on 429 (rate limit)

Switch account on 401 (expired)

Skip blocked accounts automatically

This is on by default.

9. Common Use Cases
Use with local tools

Cursor

Continue.dev

Open WebUI

Chat apps

Just set:

API Base URL → http://127.0.0.1:8045/v1

API Key → your key