giip

Windows + Antigravity Setup Guide

Learn how to install the Antigravity agent in a Windows environment and perform remote AI-driven operations through the GIIP platform.

📋 Overview

Antigravity is an autonomous agent that integrates with the GIIP platform to directly modify code or change system configurations within Windows servers. This guide helps you activate the agent and configure a secure connection.

🛠️ Installation & Setup Steps

1. Download Agent

Download the giipAgentWin.zip file from the [Agent Management] page of the GIIP platform or the official repository.

2. Issue & Configure API Key

  1. Go to [Account Settings] > [API Keys] menu and issue a new key for the agent.
  2. Open the config.json file in the downloaded folder and enter the issued key and server URL.
    {
      "apiKey": "your-api-key-here",
      "serverUrl": "https://api.giip.io"
    }

3. Run Agent & Register Service

Open PowerShell (as Administrator), navigate to the agent folder, and run the following commands:

  • Run: .\giipAgentWin.exe start
  • Register Service (Background): .\install_service.ps1

4. Verify Platform Integration

Check the [Server Detail] page on GIIP to see if the Agent Status icon for that server has turned green.

🚀 Usage Scenarios

  • Auto-resolve Issues: Call Antigravity for registered issues to analyze bugs in the source code and apply patches immediately.
  • Enhanced Monitoring: The agent collects local system metrics and transmits them to the platform in real-time.

🚨 Security Notes

  • Key Management: Ensure the API key is not exposed externally.
  • Permission Limits: We recommend keeping the permissions of the Windows account running the agent at the minimum required level.

Troubleshooting

SymptomCauseSolution
The Agent Status icon on the [Server Detail] page does not turn greenThe apiKey or serverUrl in config.json is entered incorrectlyReopen config.json to verify the values, and reissue the key from [API Keys] if needed
Running .\install_service.ps1 throws a "script cannot be loaded" errorThe PowerShell ExecutionPolicy is restrictedRun Set-ExecutionPolicy -Scope Process Bypass in an Administrator PowerShell, then retry
.\giipAgentWin.exe start fails with an authentication errorThe API key is expired or invalidReissue the key from [Account Settings] > [API Keys] and update config.json
A config file parse error occurs when the agent startsThe JSON in config.json is broken (missing quotes/commas)Validate and fix the JSON syntax in config.json

Version: 1.0 Last Updated: 2026-03-19 Source: giipv3/public/help/agent-setup-win-antigravity.en.md