Antigravity in Gemini Enterprise

Integration with Gemini Enterprise and Gemini Enterprise Agent Platform enables enterprise development teams to deploy Google Antigravity using models hosted directly within your organization’s Google Cloud infrastructure. Every session runs under Google Cloud’s enterprise security controls, data residency guarantees, and the Google Cloud Terms of Service.

Supported products: Antigravity 2.0Antigravity CLI

Note

Note: Enterprise integration is supported for Antigravity 2.0 and Antigravity CLI. Antigravity IDE is currently not supported for enterprise deployments. View Supported Models

Overview & Key Benefits

You can use Antigravity in two ways:

• Agent Platform - Connect directly to Agent Platform to use Antigravity with pay-as-you-go billing.
• Gemini Enterprise license - Connect with your Gemini Enterprise license to get access to included quotas, managed overages as well as advanced administrative controls.

By connecting Google Antigravity to your Google Cloud project, your organization gains:

Enterprise Governance

Operates under your existing Google Cloud Terms of Service with centralized administrative controls and role-based access.

Data Residency & Security

Satisfies private networking (VPC Service Controls) and regional data residency constraints. Enterprise prompts, responses, code, and telemetry are never stored outside your private environments.

Consumption Billing

Integrates directly with your Google Cloud Billing account for unified consumption invoicing at Agent Platform pricing.

Before You Begin

Make sure your environment meets the following prerequisites:

• A Gemini Enterprise Standard,Gemini Enterprise Plus or Gemini Enterprise Pay-as-you go edition. (Other editions, such as Gemini Enterprise for Business, are planned for future releases but are not currently supported).

• A Google Cloud project ID and a deployment location—global, us, or eu—that carries your license.

• For Bring Your Own Identity (BYOID), an administrator must configure Cloud Identity or Workforce Identity Federation for your organization.

• Select a project: Selecting a project doesn’t require a specific IAM role—you can select any project that you’ve been granted a role on.

Note

Note: To switch to a different Google Cloud project or location, you must first log out of the Antigravity CLI or Hub, then log back in and select your new project/location. Directly changing the project or location while logged in is currently not supported.

• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note

Note: If you don’t plan to keep the resources that you create in this procedure, create a new project instead of selecting an existing project. After you finish these steps, you can delete the project to remove all associated resources.

IAM Roles & Permissions Matrix

Before configuring your environment, review the Identity and Access Management (IAM) roles required for initial project setup and model inference:

Setup Step	Required IAM Role	Permission ID
Create GCP Project	Project Creator (roles/resourcemanager.projectCreator)	resourcemanager.projects.create
Enable Agent Platform API	Service Usage Admin (roles/serviceusage.serviceUsageAdmin)	serviceusage.services.enable
Use Antigravity Models	Agent Platform User (roles/aiplatform.user)	aiplatform.user

Administrator Setup Guide

Gemini Enterprise Setup

To setup Gemini Enterprise subscriptions, follow the official Google Cloud onboarding guide.

Gemini Enterprise Documentation

Google Cloud Environment Provisioning

Complete the following three steps to provision your Google Cloud project and enable API access.

1. Select or Create a Google Cloud Project: Select an existing project or create a dedicated project for your team’s Antigravity workloads.

   Note

   Project Switching Note: To switch to a different Google Cloud project or location, log out of the Antigravity CLI or Hub, then log back in to select your new project or region.

   Go to GCP Project Selector

2. Verify Cloud Billing: Ensure that Cloud Billing is active for your selected Google Cloud project. You can inspect your project’s billing status in the Cloud Console.

   Open Google Cloud Billing Console

3. Enable the Agent Platform API: Enable the Agent Platform API (aiplatform.googleapis.com) to allow Antigravity clients to connect to your project’s model endpoints.

   Enable Agent Platform API

Sign In & License Selection

Google Antigravity uses a single sign-on (SSO) flow. When you sign in with your corporate business account, your license tier is automatically detected without requiring manual tier selection.

Sign-In Workflow

1. Start Antigravity 2.0 or the Antigravity CLI.
2. Select Sign in to open the browser authentication flow.
3. Choose Business account (subject to the Google Cloud Terms of Service).
4. Select Continue with Google Cloud (or configure Advanced SSO / WIF).
5. Complete authentication in your browser.
6. Once authenticated, the License Selector displays your assigned licenses. Confirm the project linked to your license and select it.
7. Alternatively, select Other to self-assign a license by entering your project ID and selecting a location (global, us, or eu).

Note

Data-Sharing & Project Logging Notice: Your customer telemetry and model interactions are logged directly to the Google Cloud project corresponding to the license you select. You can maintain one license per project and location.

Bring Your Own Identity (BYOID / WIF)

Bring Your Own Identity (BYOID) uses Workforce Identity Federation (WIF) to let your organization authenticate through an external identity provider, such as Okta, instead of a standard Google Account.

Configuring BYOID

1. In Antigravity, select Business account.
2. Select Advanced WIF Configuration.
3. Enter the WIF Configuration String provided by your organization’s administrator.
4. Complete sign-in through your federated identity provider.
5. Select or self-assign a license from the License Selector.

Note

Note: If the same email address exists across multiple identity providers, sign in with the identity that matches your Gemini Enterprise license. BYOID does not currently support Agent Platform on Antigravity 2.0.

Application Default Credentials (ADC) in Antigravity CLI

For headless environments and automated terminal workflows, the Antigravity CLI supports authentication using Google Cloud Application Default Credentials (ADC).

Note

Note: Image generation is currently not available in eu and us locations.

Setting Up ADC

1. Generate local Application Default Credentials for your project using the Google Cloud SDK:

   gcloud auth application-default login --project {GCP_PROJECT}

2. Verify that your credentials file exists. On Linux and macOS, the default path is:

   ~/.config/gcloud/application_default_credentials.json

3. Enable ADC authentication by exporting the required environment variable:

   export AGY_ADC_AUTH=true

4. To sign out of ADC, unset the environment variable and restart your terminal session:

   unset AGY_ADC_AUTH

Note

ADC Limitations: ADC sign-in is supported exclusively on the Antigravity CLI. When authenticating via ADC, models older than Gemini 3 Flash are not supported.

Regional Endpoints & Capability Matrix

Antigravity CLI and Antigravity 2.0 support multi-region deployment endpoints to satisfy regional data residency requirements:

Endpoint Region	Base Endpoint URI	Supported Capabilities
Global	global	Text Generation, Code Inference, Multimodal, Image Generation
US Multi-Region	us	Text Generation, Code Inference, Multimodal
EU Multi-Region	eu	Text Generation, Code Inference, Multimodal

Note

Note: Image generation capabilities are currently available exclusively on global deployment endpoints.

For full endpoint specifications, consult the Deployment Endpoints Documentation.

Security & Governance

Request & Response Logging

Audit model interactions and maintain enterprise compliance records for your Gemini Enterprise Agent Platform instance. Learn more

VPC Service Controls (VPC-SC)

Enforce private networking security perimeters by adding the Agent Platform API to your VPC-SC perimeter. Learn more

Troubleshooting & Diagnostics

Common Sign-In & License Issues

• No Licenses Appear During Setup: Licenses are assigned by your organization’s Google Cloud administrator. If the License Selector is empty, contact your administrator to ensure your account has been granted access to a Gemini Enterprise Standard or Plus license.
• Missing BYOID Sign-In Option: Ensure you are running the latest release of Antigravity 2.0 or the Antigravity CLI, as enterprise authentication and BYOID support are included natively in all recent releases.
• Browser URL Allowlist Advisory: When a browser URL allowlist is configured in admin controls, allowlisted URLs may still be blocked in Antigravity. Admin URL allowlists are currently being integrated and are not yet honored.

Known Limitations

BYOID / WIF login:

• When signing in with the Advanced SSO option (BYOID / Workforce Identity Federation), a small number of users are unexpectedly logged out and must sign in again after restarting Antigravity 2.0 or the Antigravity CLI.
• Affected users must re-authenticate on restart.

Important API Provisioning Advisory

Caution

Enable Required APIs Before Purchasing Licenses: New Gemini Enterprise license purchases can fail or fail to provision if the Agent Platform API (aiplatform.googleapis.com) is not enabled first. Enable the API in the Google Cloud Console and wait approximately 5 minutes for propagation before completing license purchases.

Sharing Diagnostics with Support

When contacting Google Cloud Support, include the diagnostic log file from your most recent session:

• Antigravity CLI (Linux and macOS):

  ~/.gemini/antigravity-cli/cli.log

• Antigravity 2.0 (macOS):

  ~/Library/Logs/Antigravity/language_server.log

What’s Next

• Explore supported model architectures in the Models Guide.
• Learn more about enterprise privacy and compliance in Security & Governance.
• Check the Antigravity CLI Reference for headless automation commands.