Install Antigravity

macOS

For Apple Silicon (M1/M2/M3)

✓ Verified for macOS Sequoia

Windows 11

WSL2 Required

⚠️ Performance Warning:
Running native Windows? You might face lag.
→ Read our WSL2 Setup Guide first

Release Notes (v0.9.4)

System Requirements

OSmacOS 14+, Windows 11 (WSL2 required), Linux (Debian/Ubuntu)
RAM16GB minimum (32GB recommended for local models)
NetworkBroadband connection required for Gemini 3 Streaming

Detailed Installation Guide

macOS Installation Steps

  1. Download the installer: Click the download button above to get the .dmg file. The installer automatically detects whether you have an Intel or Apple Silicon Mac and installs the appropriate version. The download size is approximately 250MB.
  2. Open the installer: Double-click the downloaded .dmg file. You may see a security warning since Antigravity IDE is downloaded from the web. Click "Open" to proceed. If blocked, go to System Settings → Privacy & Security and click "Open Anyway".
  3. Drag to Applications: In the installer window, drag the Antigravity icon to the Applications folder. This will copy the application to your system. The installation requires about 1GB of disk space.
  4. First launch: Open Antigravity from your Applications folder or Launchpad. On first launch, macOS will verify the application, which may take 30-60 seconds. Grant necessary permissions when prompted.
  5. Configure AI models: On startup, Antigravity will prompt you to connect to Gemini 3 or configure alternative AI models. You can use your Google account for authentication or set up API keys for other providers.
Pro Tip: For Apple Silicon Macs, ensure you have Rosetta 2 installed for compatibility with x86 extensions. Run softwareupdate --install-rosetta in Terminal if needed.

Windows 11 Installation Steps

  1. Prerequisite - Install WSL2: Antigravity IDE requires Windows Subsystem for Linux 2 for optimal performance. Open PowerShell as Administrator and run wsl --install. This installs Ubuntu by default and enables necessary features. Restart your computer after installation completes.
  2. Update WSL2: After restart, open PowerShell and run wsl --update to ensure you have the latest WSL2 kernel. This resolves many compatibility issues and improves performance significantly.
  3. Download Antigravity installer: Download the .exe installer from the button above. The installer is about 280MB and includes all necessary components for Windows integration.
  4. Run the installer: Right-click the downloaded installer and select "Run as Administrator". Follow the installation wizard. Choose your installation directory (default: C:\Program Files\Antigravity) and select whether to add to PATH.
  5. Configure WSL integration: During installation, Antigravity will detect your WSL2 distributions. Select your preferred distribution (Ubuntu recommended) for development. The installer will configure seamless file system access.
  6. Windows Defender exclusion: For better performance, add Antigravity's directory to Windows Defender exclusions. The installer can do this automatically if you check the option, or you can do it manually in Windows Security settings.
Important: Native Windows installation without WSL2 is possible but not recommended. You'll experience 3-5x slower performance and limited functionality. Always use WSL2 for production work.

Linux Installation Steps

  1. Download the AppImage: Linux users should download the universal AppImage format, which works across all major distributions including Ubuntu, Fedora, Arch, and Debian. The file is approximately 270MB.
  2. Make executable: Open Terminal, navigate to your Downloads folder, and runchmod +x Antigravity-*.AppImage to make the file executable.
  3. Run Antigravity: Execute the AppImage directly with ./Antigravity-*.AppImage. No installation required - the app runs directly from the file.
  4. Optional - System integration: For desktop integration, use AppImageLauncher or manually create a .desktop file. Copy the AppImage to ~/.local/bin/ for permanent access from anywhere in terminal.
  5. GPU acceleration (optional): For NVIDIA GPU users, install CUDA toolkit for accelerated local AI model inference. AMD users can configure ROCm for similar benefits. This significantly improves performance with local models.
Alternative packages: Antigravity is also available via Snap (snap install antigravity --classic) and Flatpak for sandboxed installation.

Post-Installation Configuration

Essential Setup Steps

1. AI Model Configuration

Antigravity IDE supports multiple AI models. The default Gemini 3 provides the best experience, but you can also configure Claude 3.5 Sonnet, GPT-4, or local models like CodeLlama. Navigate to Settings → AI Models to add your API keys and select your preferred model for different tasks (code generation, review, documentation).

2. Extension Installation

Essential extensions enhance Antigravity's capabilities. Install the official Extension Pack which includes Git integration, syntax highlighting for 150+ languages, debugging tools, and database clients. Access the Extension Marketplace from the sidebar or press Ctrl+Shift+X (Cmd+Shift+X on Mac).

3. Agent Configuration

Antigravity's Agent system is its killer feature. Configure specialized agents for different tasks: Architect for system design, Debugger for troubleshooting, Reviewer for code quality, and Designer for UI/UX. Each agent can be customized with specific instructions and context. Access Agent Manager from the toolbar or press Ctrl+Shift+A.

4. Performance Optimization

Optimize Antigravity for your hardware. For machines with 16GB RAM, limit the context window to 100K tokens. For 32GB+ systems, you can use the full 1M token context. Adjust in Settings → Performance. Enable GPU acceleration if available for 2-3x faster local model inference.

Troubleshooting Common Issues

Installation fails on Windows?

This usually occurs when WSL2 is not properly installed or updated. First, ensure Windows 11 is fully updated. Then run wsl --update in PowerShell as Administrator. If the problem persists, uninstall WSL completely using wsl --unregister Ubuntu and reinstall with wsl --install.

Also check that virtualization is enabled in your BIOS settings. This is required for WSL2 to function properly.

macOS security blocks the app?

macOS Gatekeeper may prevent Antigravity from opening. Go to System Settings → Privacy & Security, scroll down, and click "Open Anyway" next to the Antigravity message. You'll need to enter your password to confirm.

For recurring issues, you can temporarily disable Gatekeeper with sudo spctl --master-disablebut remember to re-enable it after installation for security.

Linux AppImage won't run?

Ensure the AppImage has execute permissions: chmod +x Antigravity-*.AppImage. If you get a FUSE error, install fuse2: sudo apt install libfuse2 on Ubuntu/Debian or equivalent for your distribution.

For Wayland users experiencing display issues, try running with GDK_BACKEND=x11 ./Antigravity-*.AppImage.

Getting Started Resources

Next Steps After Installation