antigravity-sdk-python

环境要求

• Python 环境（可执行 pip 与 python 命令）
• 可访问 PyPI 的网络，用于安装平台对应的 wheel 包
• 一个 GEMINI_API_KEY（Google Gemini API 密钥）
• 如需使用 Vertex/企业平台模式，需准备 api_key 或 ADC 凭证

安装与启动步骤

1. 1安装 SDK

   从 PyPI 安装官方包，会一并获取平台专用的编译运行时二进制文件。切勿只克隆仓库而不安装。

   pip install google-antigravity

   复制

2. 2克隆示例仓库

   README 中的示例脚本放在仓库 examples/ 目录下，克隆后才能本地运行这些示例。

   git clone https://github.com/google-antigravity/antigravity-sdk-python.git
   cd antigravity-sdk-python

   复制

3. 3配置 API 密钥

   把环境变量 GEMINI_API_KEY 设为你的真实密钥，SDK 与示例脚本会读取它进行鉴权。

   export GEMINI_API_KEY="your_api_key_here"

   复制

4. 4运行入门示例

   执行 hello_world 示例验证安装与鉴权是否都正常，成功后会打印智能体返回的文本。

   python ./examples/getting_started/hello_world.py

   复制

5. 5改用 Vertex 模式

   使用 Gemini Enterprise Agent Platform（原 Vertex AI）时，在配置中设置 vertex=True 并传入 api_key。

   from google.antigravity import Agent, LocalAgentConfig
   
   config = LocalAgentConfig(
       vertex=True,
       api_key="your_api_key_here",
   )
   
   async with Agent(config) as agent:
       response = await agent.chat("What files are here?")
       print(await response.text())

   复制

6. 6高级会话用法

   需要自己控制连接生命周期时，用 Conversation 配合 LocalConnectionStrategy 和 ToolRunner。

   import asyncio
   from google.antigravity.connections.local import LocalConnectionStrategy
   from google.antigravity.conversation.conversation import Conversation
   from google.antigravity.tools.tool_runner import ToolRunner
   
   async def main():
       tool_runner = ToolRunner()
       strategy = LocalConnectionStrategy(tool_runner=tool_runner)
       async with Conversation.create(strategy) as conversation:
           response = await conversation.chat("What files are here?")
           print(await response.text())
           print(f"Total steps: {len(conversation.history)}")
           print(f"Turns: {conversation.turn_count}")
   
   asyncio.run(main())

   复制

关键配置

如何确认成功

运行 hello_world 示例后能正常打印出智能体返回文本、无报错，即表示安装与鉴权成功。

常见问题

注意事项

• 安装必须从 PyPI 进行，克隆仓库仅用于获取 examples/ 示例代码，本身不足以运行 SDK。
• API Key 属于敏感信息，不要硬编码进源码或提交到版本库，建议用环境变量方式注入。
• Vertex 模式与 Gemini API Key 模式需要分别按 README 的两种鉴权方式配置。