agbcloud-sdk
agbcloud/agbcloud-sdk加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
想象这样一个场景：你正在开发一个 AI 编程助手，它需要在真实浏览器中操作网页、在 Linux 桌面环境中运行命令、在文件系统里读写文件——而不是在"沙盒"里模拟一切。传统的做法是本地部署一套复杂的虚拟机或 Docker 环境，不仅配置繁琐，还经常遇到"在我机器上能跑"的环境兼容性问题。
AGB Cloud SDK 正是为解决这一痛点而生。它将云端沙箱环境封装成一套简洁的 SDK，开发者只需几行代码，就能让 AI Agent 拥有一双"真实的手"：控制真实浏览器、操作真实桌面、执行真实命令。
简单来说：AGB = 云端的 AI 工作站，SDK 版本的 Computer Use 能力。
AGB（All-in-One Cloud）由 AGB Team 开发，定位为 AI-Native Cross-Platform Sandboxes for Developers。项目的核心理念是：未来的 AI Agent 不应该只运行在 LLM 的"思维空间"里，它们需要真实的环境来感知、操作和验证。
这一理念与 OpenAI 的 Computer Use、Anthropic 的 Tool Use 趋势完全一致。但 AGB 走得更远——它不仅提供代码执行，还提供了：
截至目前，AGB Cloud SDK 在 GitHub 拥有 274 颗星，PyPI 月下载量稳定增长，Discord 社区活跃，反映出开发者对"真实环境 AI 执行"这一方向的高度认可。
这是最基础也最实用的功能。AGB 在云端提供隔离的 Linux 执行环境，支持 Python、JavaScript/TypeScript、Shell 等多种语言。
from agb import AGB
from agb.session_params import CreateSessionParams
agb = AGB(api_key="your-api-key")
params = CreateSessionParams(image_id="agb-code-space-1")
result = agb.create(params)
if result.success:
session = result.session
# 执行 Python 代码
code_result = session.code.run("print('Hello AGB!')", "python")
print(code_result.result)
# 执行 Shell 命令
cmd_result = session.command.execute("ls -la")
print(cmd_result.output)
agb.delete(session)
技术细节：
AGB 的浏览器模块基于 Playwright，但增加了 AI 原生的增强能力：
# 自然语言操作浏览器
session.browser.natural_language("在 Google 搜索 'AGB cloud'")
# 截图捕获
screenshot = session.browser.screenshot()
# 数据提取
data = session.browser.extract_data("提取所有商品价格")
与普通 Playwright 的关键区别：
这是 AGB 最具差异化的功能。它提供了对完整 Linux 桌面的控制能力：
# 控制鼠标
session.computer.mouse.click(x=100, y=200)
session.computer.mouse.move(x=300, y=400)
# 控制键盘
session.computer.keyboard.type("Hello World")
session.computer.keyboard.press("Enter")
# 窗口管理
windows = session.computer.window.list()
session.computer.window.focus("VSCode")
# 应用管理
session.computer.app.launch("firefox")
session.computer.app.close("gedit")
这意味着：AI Agent 可以像真实用户一样操作桌面应用，完成 GUI 测试、文档处理、截图分析等任务。
传统云端执行环境的问题是：会话结束后，所有状态都消失了。AGB 的上下文管理解决了这一问题：
from agb.context_sync import ContextSync, SyncPolicy, UploadPolicy
# 自动同步浏览器数据
session.file.write("/tmp/context.json", json.dumps(data))
session.context.sync(policy=SyncPolicy(
upload_policy=UploadPolicy(auto_upload=True)
))
支持同步的内容包括：
门槛评估：
安装方式（pip / npm）：
pip install agbcloud-sdk
npm install agbcloud-sdk
认证方式： 支持环境变量 AGB_API_KEY 或代码中直接传入。
agb/
├── api/ # HTTP 通信层
│ ├── client.py # MCP 协议客户端
│ ├── http_client.py # HTTP 请求封装
│ └── models/ # 60+ Pydantic 请求/响应模型
├── modules/
│ ├── browser/ # 浏览器自动化（Playwright 封装）
│ └── computer/ # Linux 桌面控制（鼠标、键盘、窗口、应用）
├── session.py # Session 生命周期管理
├── context.py # 上下文服务
└── context_sync.py # 上下文同步策略
技术栈：
代码质量评估：
1. 云端依赖是一把双刃剑 AGB 所有功能都运行在 AGB 的云端基础设施上。这意味着：
2. 无本地部署选项 没有 Dockerfile 或 docker-compose，无法在本地私有化部署。这对于有严格数据合规要求的企业（如金融、医疗）是一个障碍。
3. 生态仍在早期 虽然文档完善，但社区规模相对较小，第三方集成案例不多，长期维护和社区支持有待观察。
AGB 代表了一个重要趋势：AI Agent 的能力边界正在从"语言生成"扩展到"物理执行"。
当 AI Agent 能够：
它就不再只是一个"聊天机器人"，而是一个真正的数字工作者。
这一方向的核心挑战不是"让 AI 思考"，而是"让 AI 可靠地行动"。AGB 通过提供标准化、可靠的云端执行环境，为这一挑战提供了务实的解决方案。
增长曲线参考： 2024-2025 年，OpenAI Anthropic、Microsoft 相继推出 Computer Use 相关能力，AGB 作为开源社区的重要参与者，在 SDK 化和跨平台支持方面具有独特价值。