[!重要] 为了长期可持续性，源代码已迁移到私有仓库。 二进制文件、Docker镜像和发布版本将继续在此处发布。

想获取源代码访问权限吗？

• 在此仓库中开启讨论
• 加入我们的Telegram，并私信我

只读访问权限可根据请求授予。

ZeroGravity

原生支持Gemini的代理，同时兼容OpenAI和Anthropic的接口，外观上看起来就像真实的Antigravity流量发送给Google一样。

早期阶段。 我曾在OpenCode平台上使用Ultra账号连续运行了3天，期间一直在进行压力测试，目前尚未发现任何问题。

本软件是在Linux上开发的。我的目标是尽可能支持所有操作系统，因此如果您遇到任何问题，请提交一个问题，我会很乐意为您提供帮助。

请给这个仓库点个赞，让更多人能在它还能正常工作时找到它。欢迎提出问题和PR。

路线图进展

该项目正在按照分阶段的v2.0.0路线图推进。简而言之： Docker优先的原生运行时基础已经搭建完毕，主要的身份验证和运行时初始化工作也已完成，剩下的工作主要是将“运行良好”与“尽可能接近真实Antigravity行为”之间的差距缩小。

阶段状态

子任务快照

• 完成：
  • Docker是受支持的运行时。
  • 真实Antigravity运行流程已实现。
  • 初步的身份验证、运行时初始化及会话连续性已就绪。
  • 基本的加固措施和面向运维人员的诊断功能已到位。
  • 已发布的原生提示路径已在公共请求界面上实现。
  • 发布的原生通道现在负责身份验证、项目和请求元数据的行为，不再依赖于代理端的修复作为常态。
• 进行中：
  • 最终的端到端一致性验证和发布审批。

本节内容有意保持高度概括。公开仓库记录了已发布的功能、正在优化的内容以及未来计划，而不会涉及私有的实现细节。

不用看这里——这是AI时代

只需将以下内容粘贴到任何LLM或智能体中，让它为您解释并完成设置：

阅读此README和链接的文档，以了解ZeroGravity的功能及其设置方法。然后检测我的操作系统，帮我获取刷新令牌，并运行docker-init来启动它：https://raw.githubusercontent.com/NikkeTryHard/zerogravity/refs/heads/main/README.md

模型

快速入门

1. 获取刷新令牌

您需要一个来自 Antigravity 账号的刷新令牌。

[!CAUTION] 请务必从官方 Antigravity 应用中提取令牌。 请勿使用第三方 OAuth 工具（例如 Antigravity Manager）登录新账号——这些工具的 OAuth 流程生成的令牌指纹不同，可能会被标记为可疑。请使用 zg extract 命令从 Antigravity 已有的会话中提取令牌。zg import 命令仅适用于迁移您已经在其他地方提取过的账号。

从 Antigravity（推荐）：

1. 在您的桌面安装 Antigravity。
2. 使用您的 Google 账号登录。
3. 运行 zg extract — 该命令会将刷新令牌复制到 accounts.json 文件中（Linux：~/.config/zerogravity/，macOS：~/Library/Application Support/zerogravity/，Windows：%APPDATA%\zerogravity\）。

首选操作模式： 每个容器只启动一个真实账号。如果您后续需要更高的吞吐量，可以运行另一个包含不同账号的容器，而不是默认采用多账号轮转的方式。

从 Antigravity Manager（仅适用于现有账号）：

1. 从 Antigravity Manager 导出账号（设置 → 导出）。
2. 运行 zg import /path/to/exported_accounts.json。

2. 使用 Docker 启动

[!WARNING] Docker 是运行 ZeroGravity 代理的唯一受支持方式。 如果您仍在使用原生安装，请考虑切换——今后开发将仅在 Docker 环境中进行。zg 仍将以跨平台管理工具的身份继续工作。

# 在当前目录生成 docker-compose.yml 和 accounts.json
zg docker-init

# 启动代理
docker compose up -d

# 验证是否正在运行
curl http://localhost:8741/health

注意： Docker 镜像已打包所有必要的后端组件，无需在宿主机上安装 Antigravity。有关高级设置，请参阅 Docker 指南。

3. 连接您的客户端

代理默认监听 端口 8741。请将您的 API 客户端指向 http://localhost:8741。

Gemini 兼容（推荐——零转换直通）：

http://localhost:8741/v1beta

OpenAI 兼容（ChatGPT 客户端、Cursor、Continue 等）：

http://localhost:8741/v1

Anthropic 兼容（Claude Code 等）：

http://localhost:8741

[!TIP] 从您的宿主机： localhost:8741 可直接使用（端口已在 docker-compose 中映射）。 从同一 compose 中的另一个容器： 使用 zerogravity:8741（服务名称）。 从远程机器： 使用 <host-ip>:8741。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "zerogravity": {
      "npm": "@ai-sdk/google",
      "name": "ZeroGravity (Gemini)",
      "options": {
        "apiKey": "not-needed",
        "baseURL": "http://localhost:8741/v1beta",
      },
      "models": {
        "gemini-3-flash": {
          "name": "Gemini 3 Flash",
          "limit": { "context": 1048576, "output": 65536 },
        },
        "gemini-3.1-pro": {
          "name": "Gemini 3.1 Pro",
          "limit": { "context": 1048576, "output": 65536 },
        },
      },
    },
  },
  "model": "zerogravity/gemini-3-flash",
}

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "zerogravity": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "ZeroGravity",
      "options": {
        "apiKey": "not-needed",
        "baseURL": "http://localhost:8741/v1",
      },
      "models": {
        "gemini-3-flash": {
          "name": "Gemini 3 Flash",
          "limit": { "context": 1048576, "output": 65536 },
        },
        "opus-4.6": {
          "name": "Claude Opus 4.6",
          "limit": { "context": 200000, "output": 65536 },
          "thinking": { "type": "adaptive" },
        },
        "sonnet-4.6": {
          "name": "Claude Sonnet 4.6",
          "limit": { "context": 200000, "output": 65536 },
          "thinking": { "type": "adaptive" },
        },
      },
    },
  },
  "model": "zerogravity/gemini-3-flash",
}

{
  "plugin": ["oh-my-opencode"],
  // oh-my-opencode.json（同一目录）
  // 将每个子代理模型设置为“zerogravity/gemini-3-flash”
}

4. 测试

# 使用 zg 快速测试
zg test "say hi"

# 或者直接使用 curl
curl http://localhost:8741/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model": "gemini-3-flash", "messages": [{"role": "user", "content": "hi"}]}'

终端节点

代理默认运行在 http://localhost:8741。

完整终端节点列表（账户、令牌、用量、配额、搜索）请参阅 API 参考文档。

图片

当模型生成一张图片时，它会被保存并在 http://localhost:8741/v1/images/<id>.png 提供。响应中会包含该图片的 URL，无需额外配置。

认证

代理使用刷新令牌进行持久化认证。刷新令牌会自动续期访问令牌，无需手动管理令牌。

获取刷新令牌

请参阅上方的【快速入门】第 1 步：获取刷新令牌。

从 Antigravity Manager 导入现有账户

[!警告] 仅用于导入已提取的账户。 请勿使用 Antigravity Manager 登录新账户——始终使用官方的 Antigravity 应用程序和 zg extract 命令。

Antigravity Manager 会将账户导出为一个扁平的 JSON 数组：

[
  { "email": "user@gmail.com", "refresh_token": "1//0fXXX" },
  { "email": "user2@gmail.com", "refresh_token": "1//0fYYY" }
]

推荐使用 zg 命令：

zg import /path/to/antigravity_accounts.json

此命令会自动检测格式、转换并合并到您现有的 accounts.json 文件中。

手动转换方法： 将数组包裹在以下模式中——在外层添加 "accounts":，并可选择性地将 "active" 设置为第一个邮箱地址。

accounts.json 模式

代理会从配置目录下的 accounts.json 文件中读取账户信息：

可通过设置环境变量 ZEROGRAVITY_CONFIG_DIR 来覆盖默认路径。

{
  "accounts": [
    {
      "email": "user@gmail.com",
      "refresh_token": "1//0fXXXXXXXXXX",
      "extracted_at": "2026-02-21T05:08:32Z"
    }
  ],
  "active": "user@gmail.com"
}

自定义

系统提示模式： 三种模式控制 ZeroGravity 如何处理后端的系统提示。native（默认）几乎原样保留 AG 请求——AG 的工具、系统提示和生成配置都被保留，仅将占位提示替换为真实用户文本。双向工具翻译会将 AG 工具名称映射为客户端名称并反向映射。适用于所有 API 端点（OpenAI、Anthropic、Responses、Gemini v1beta）。stealth 会去除 AG 身份标识，并注入客户端工具和系统提示。minimal 则会完全替换掉 20KB 的后端系统提示——虽然可以节省 token，但可能会触发 Pro 模型的速率限制。

敏感词混淆： 像 OpenCode、Cursor、Claude Code 这样的客户端名称会自动使用不可见字符进行混淆，从而防止 Google 在请求日志中搜索这些关键词。

完整的环境变量参考请参阅 Docker 指南。

文档

许可证

MIT

ZeroGravity 快速上手指南

ZeroGravity 是一个高性能代理工具，能让你的本地 AI 开发工具（如 Cursor、Claude Code、OpenCode 等）直接调用 Google 的 Gemini 前沿模型。它通过模拟真实的 Antigravity 用户流量，无需 API Key 即可使用，支持 OpenAI 和 Anthropic 兼容接口。

注意：源代码已移至私有仓库，但二进制文件、Docker 镜像和发布版本仍在此公开。本项目仅支持 Docker 部署。

环境准备

• 操作系统：Linux、macOS 或 Windows
• 前置依赖：
  • Docker 及 Docker Compose
  • 官方桌面版 Antigravity 客户端（用于获取认证令牌）
  • zg 命令行工具（通常包含在发布包中，或通过项目释放页下载）

安装步骤

1. 获取刷新令牌 (Refresh Token)

你需要从官方 Antigravity 客户端提取令牌。切勿使用第三方 OAuth 工具登录新账号，以免被标记。

1. 下载并安装 Antigravity 桌面端。
2. 使用你的 Google 账号登录。
3. 在终端运行以下命令，令牌将自动提取并保存至配置文件：

   zg extract
   

   配置文件默认路径：
   • Linux: ~/.config/zerogravity/accounts.json
   • macOS: ~/Library/Application Support/zerogravity/accounts.json
   • Windows: %APPDATA%\zerogravity\accounts.json

2. 初始化并启动 Docker

ZeroGravity 推荐使用 Docker 运行，镜像已包含所有后端组件。

1. 在当前目录生成 docker-compose.yml 和配置文件：

   zg docker-init
   

2. 启动服务：

   docker compose up -d
   

3. 验证服务状态：

   curl http://localhost:8741/health
   

基本使用

代理服务默认监听 8741 端口。你可以将其配置到任何支持自定义 API 地址的 AI 工具中。

接口地址选择

根据你的客户端类型选择对应的 endpoint：

• Gemini 原生协议（推荐，零转换损耗）： http://localhost:8741/v1beta
• OpenAI 兼容协议（适用于 Cursor, Continue, ChatGPT 客户端等）： http://localhost:8741/v1
• Anthropic 兼容协议（适用于 Claude Code 等）： http://localhost:8741

测试连接

方法一：使用内置命令测试

zg test "say hi"

方法二：使用 Curl 直接测试

curl http://localhost:8741/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model": "gemini-3-flash", "messages": [{"role": "user", "content": "hi"}]}'

可用模型列表

提示：在配置客户端时，apiKey 字段可填写任意内容（除非你手动设置了 ZEROGRAVITY_API_KEY 环境变量），系统主要依赖提取的 Refresh Token 进行认证。