Getting Started

This chapter guides you through using Antigravity Tools from scratch, covering the complete workflow from installation to your first successful API call. You'll learn core concepts, account management, data backup, and how to connect your AI client to the local gateway.

In This Chapter

What is Antigravity Tools

Build the right mental model: core concepts and usage boundaries of local gateway, protocol compatibility, and account pool scheduling.

Installation & Upgrades

Best installation paths for desktop (brew / releases), and handling common system interceptions.

First Run Essentials

Data directory, logs, tray icon, and auto-startup to avoid accidental deletion and irreversible loss.

Add Accounts

OAuth/Refresh Token dual channels and best practices for building your account pool reliably.

Backup & Migration

Import/export, V1/DB hot migration, supporting multi-machine reuse and server deployment scenarios.

Start Reverse Proxy & Connect Client

From starting the service to successful external client calls, complete the verification loop in one go.

Learning Path

Recommended Order

Follow this order to get started with Antigravity Tools quickly:

1. Concepts        →  2. Installation     →  3. Data Directory
   getting-started      installation          first-run-data
        ↓                    ↓                      ↓
4. Add Accounts     →  5. Backup         →  6. Start Proxy
   add-account          backup-migrate        proxy-and-first-client

Step	Lesson	Estimated Time	What You'll Learn
1	Concepts	5 min	What is a local gateway, why you need an account pool
2	Installation	3 min	brew install or manual download, handling system interception
3	Data Directory	5 min	Where data is stored, how to read logs, tray operations
4	Add Accounts	10 min	OAuth authorization or manual Refresh Token entry
5	Backup	5 min	Export accounts, cross-device migration
6	Start Proxy	10 min	Start service, configure client, verify calls

Minimum viable path: If you're in a rush, you can complete 1 → 2 → 4 → 6 in about 25 minutes to get started.

Next Steps

After completing this chapter, you should be able to use Antigravity Tools normally. Next, you can dive deeper based on your needs:

• Platforms & Integrations: Learn integration details for OpenAI, Anthropic, Gemini, and other protocols
• Advanced Configuration: Model routing, quota protection, high-availability scheduling, and other advanced features
• FAQ: Troubleshooting guide for 401, 429, 404, and other errors