Explore our next generation products
Built for developers in the agent-first era
Everything you need to stay up-to-date and get help
Antigravity in Gemini Enterpriselink
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.0 Antigravity CLI
Overview & Key Benefitslink
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 Subscription - Connect with your Gemini Enterprise Standard or Plus 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.
- 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 Beginlink
Make sure your environment meets the following prerequisites:
- A Gemini Enterprise Standard or Gemini Enterprise Plus subscription. (Other subscription tiers, 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, oreu—that carries your license. - For Bring Your Own Identity (BYOID), an administrator must configure Cloud Identity or Workforce Identity Federation for your organization.
IAM Roles & Permissions Matrixlink
Before configuring your environment, review the Identity and Access Management (IAM) roles required for initial project setup and model inference:
| Action / 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 Guidelink
Gemini Enterprise Setuplink
To setup Gemini Enterprise subscriptions, follow the official Google Cloud onboarding guide.
Gemini Enterprise DocumentationGoogle Cloud Environment Provisioninglink
Complete the following three steps to provision your Google Cloud project and enable API access.
Step 1: Select or Create a Google Cloud Project
Select an existing project or create a dedicated project for your team’s Antigravity workloads.
Step 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 ConsoleStep 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.
Sign In & License Selectionlink
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 Workflowlink
- Start Antigravity 2.0 or the Antigravity CLI.
- Select Sign in to open the browser authentication flow.
- Choose Business account (subject to the Google Cloud Terms of Service).
- Select Continue with Google Cloud (or configure Advanced SSO / WIF).
- Complete authentication in your browser.
- Once authenticated, the License Selector displays your assigned licenses. Confirm the project linked to your license and select it.
- Alternatively, select Other to self-assign a license by entering your project ID and selecting a location (
global,us, oreu).
Bring Your Own Identity (BYOID / WIF)link
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 BYOIDlink
- In Antigravity, select Business account.
- Select Advanced WIF Configuration.
- Enter the WIF Configuration String provided by your organization’s administrator.
- Complete sign-in through your federated identity provider.
- Select or self-assign a license from the License Selector.
Application Default Credentials (ADC) in Antigravity CLIlink
For headless environments and automated terminal workflows, the Antigravity CLI supports authentication using Google Cloud Application Default Credentials (ADC).
Setting Up ADClink
- Generate local Application Default Credentials for your project using the Google Cloud SDK:
bash
gcloud auth application-default login --project {GCP_PROJECT} - Verify that your credentials file exists. On Linux and macOS, the default path is:
bash
~/.config/gcloud/application_default_credentials.json - Enable ADC authentication by exporting the required environment variable:
bash
export AGY_ADC_AUTH=true - To sign out of ADC, unset the environment variable and restart your terminal session:
bash
unset AGY_ADC_AUTH
Regional Endpoints & Capability Matrixlink
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 |
global deployment endpoints.For full endpoint specifications, consult the Deployment Endpoints Documentation.
Security & Governancelink
Audit model interactions and maintain enterprise compliance records for your Gemini Enterprise Agent Platform instance.
Enforce private networking security perimeters by adding the Agent Platform API to your VPC-SC perimeter.
Troubleshooting & Diagnosticslink
Common Sign-In & License Issueslink
- 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 Limitationslink
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 Advisorylink
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 Supportlink
When contacting Google Cloud Support, include the diagnostic log file from your most recent session:
- Antigravity CLI (Linux and macOS):
bash
~/.gemini/antigravity-cli/cli.log - Antigravity 2.0 (macOS):
bash
~/Library/Logs/Antigravity/language_server.log
What’s Nextlink
- 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.