Google Antigravity Complete Installation & Setup Guide 2025: From Download to First Project

Welcome to the definitive guide for installing and setting up Google Antigravity, the revolutionary AI-powered IDE featuring Gemini 3. Whether you're on Mac, Windows, or Linux, this guide will have you coding with AI assistance in minutes.

New to AI coding? Check out our beginner's guide to prompts and getting started with Antigravity for foundational knowledge.

What is Google Antigravity?

Google Antigravity is Google's AI-native integrated development environment (IDE) powered by Gemini 3, offering:

• 1 million token context window - understands your entire codebase
• Agent Mode - autonomous task execution (learn more about Agent Mode)
• MCP Integration - connect to databases, APIs, and tools (MCP server guide)
• Multi-language support - Python, TypeScript, React, and more

Considering alternatives? See our comparisons:

• Antigravity vs Cursor
• Antigravity vs GitHub Copilot
• Antigravity vs Windsurf

---

System Requirements

Minimum Requirements

Component	Requirement
OS	macOS 12+, Windows 10+, Ubuntu 20.04+
RAM	8GB
Storage	2GB free space
CPU	64-bit processor
Internet	Required for AI features

Recommended Specifications

Component	Recommendation
RAM	16GB or more
Storage	SSD with 10GB+ free
CPU	Apple M1+ or Intel i7/AMD Ryzen 7
Display	1920x1080 or higher

---

Installation Guide

macOS Installation

Step 1: Download

# Using Homebrew (recommended)
brew install --cask google-antigravity

# Or download directly from Google
curl -O https://dl.google.com/antigravity/latest/Antigravity-mac.dmg

Step 2: Install

1. Open the downloaded .dmg file
2. Drag Antigravity to Applications folder
3. Right-click and select "Open" (first time only)
4. Grant necessary permissions when prompted

Step 3: Verify Installation

antigravity --version
# Expected output: Antigravity 2.x.x

Windows Installation

Step 1: Download

• Visit the official download page
• Select "Windows" version
• Download the .exe installer

Step 2: Install

1. Run the installer as Administrator
2. Accept the license agreement
3. Choose installation directory
4. Select "Add to PATH" option
5. Complete installation

Step 3: Verify

antigravity --version

Linux Installation

Ubuntu/Debian:

# Add repository
curl -fsSL https://dl.google.com/antigravity/gpg | sudo gpg --dearmor -o /usr/share/keyrings/antigravity.gpg

echo "deb [signed-by=/usr/share/keyrings/antigravity.gpg] https://dl.google.com/antigravity/deb stable main" | sudo tee /etc/apt/sources.list.d/antigravity.list

# Install
sudo apt update
sudo apt install antigravity

Fedora/RHEL:

sudo dnf install antigravity

AppImage (Universal):

chmod +x Antigravity-*.AppImage
./Antigravity-*.AppImage

Having issues? Check our comprehensive troubleshooting guide for solutions.

---

Initial Configuration

First Launch Setup

1. Sign in with Google Account

   • Click "Sign In"
   • Use your Google account
   • Authorize Antigravity access

2. Choose Your Plan

   • Free: 50 AI requests/day
   • Pro: Unlimited AI + Agent Mode
   • Team: Collaboration features

3. Select Theme

   • Dark (recommended for coding)
   • Light
   • System preference

Essential Settings

Access settings: Cmd/Ctrl + ,

{
  "ai.model": "gemini-3",
  "ai.contextWindow": "large",
  "editor.fontSize": 14,
  "editor.tabSize": 2,
  "editor.formatOnSave": true,
  "ai.agentMode.enabled": true
}

Configure MCP Servers

MCP servers extend Antigravity's capabilities. Create ~/.config/antigravity/mcp.json:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-filesystem", "/projects"]
    }
  }
}

Browse our MCP server directory for ready-to-use configurations, or read the complete MCP guide.

---

Understanding the Interface

Main Areas

┌─────────────────────────────────────────────────────────┐
│  Menu Bar                                               │
├──────────┬──────────────────────────────┬───────────────┤
│          │                              │               │
│  File    │                              │   AI Chat     │
│  Explorer│      Editor Area             │   Panel       │
│          │                              │               │
│          │                              │               │
├──────────┴──────────────────────────────┴───────────────┤
│  Terminal / Output / Problems                           │
└─────────────────────────────────────────────────────────┘

Key Panels

1. File Explorer (Cmd/Ctrl + B): Browse project files
2. AI Chat Panel (Cmd/Ctrl + L): Interact with Gemini 3
3. Terminal (Cmd/Ctrl + `): Integrated terminal
4. Command Palette (Cmd/Ctrl + Shift + P): Quick actions

---

Your First Project: Building a Task Manager API

Let's build something practical using Antigravity's AI features.

Step 1: Create Project

mkdir task-manager-api
cd task-manager-api
antigravity .

Step 2: Initialize with AI

Open the AI chat (Cmd/Ctrl + L) and type:

Initialize a Node.js Express API project with TypeScript.
Include: 
- Express server setup
- TypeScript configuration
- Basic folder structure
- Package.json with scripts

Step 3: Create the Task Model

Ask the AI:

Create a Task model with:
- id (uuid)
- title (string)
- description (string, optional)
- status (pending, in_progress, completed)
- createdAt, updatedAt timestamps

Step 4: Build CRUD Endpoints

Create REST endpoints for tasks:
- GET /tasks - list all
- GET /tasks/:id - get one
- POST /tasks - create
- PUT /tasks/:id - update
- DELETE /tasks/:id - delete

Include input validation and error handling.

Step 5: Test Your API

# Start the server
npm run dev

# Test with curl
curl http://localhost:3000/tasks

Want more projects? Explore our use cases and best practices for real-world implementations.

---

Essential Keyboard Shortcuts

Master these shortcuts for maximum productivity:

Action	Mac	Windows/Linux
AI Chat	Cmd + L	Ctrl + L
Command Palette	Cmd + Shift + P	Ctrl + Shift + P
Quick AI Action	Cmd + K	Ctrl + K
Agent Mode	Cmd + Shift + A	Ctrl + Shift + A
Toggle Terminal	Cmd + `	Ctrl + `
File Search	Cmd + P	Ctrl + P
Global Search	Cmd + Shift + F	Ctrl + Shift + F

---

Next Steps

Now that you're set up, continue your journey:

1. Learn Prompt Engineering - Write better prompts for better results
2. Master Agent Mode - Autonomous task execution
3. Configure MCP Servers - Connect databases and APIs
4. Browse Prompts - Community-tested prompts for every use case
5. Explore MCP Directory - Ready-to-use server configurations

Join the Community

• Community Hub - Connect with other developers
• Submit Your Prompts - Share your best prompts
• Trending Content - See what's popular

---

Troubleshooting Quick Reference

Issue	Solution
Won't start	Clear cache: rm -rf ~/.config/antigravity/Cache
AI not responding	Check internet, verify API key
Slow performance	Disable unused extensions
MCP server error	Check credentials in mcp.json

For detailed solutions, see our complete troubleshooting guide.

---

Last updated: December 2025

Related Articles:

• Google Antigravity vs Windsurf Comparison
• MCP Servers Complete Guide
• Agent Mode Mastery
• Troubleshooting Guide