项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 11066
技术标签
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 安装 Docker 与 Docker Compose
- 准备 AI 服务商的 API Key(如 ANTHROPIC_API_KEY、OPENAI_API_KEY 或 GEMINI_API_KEY)
- 可访问 GitHub 与容器镜像仓库的网络环境
- 本地需预留运行容器化 Linux 桌面的资源
安装与启动步骤
-
1克隆仓库
从 GitHub 拉取 bytebot 源码到本地,后续所有 Docker 配置都在该目录下操作。
git clone https://github.com/bytebot-ai/bytebot.git -
2进入项目目录
切换到克隆下来的 bytebot 目录,确认能看到 docker 子目录。
cd bytebot -
3写入 API Key
在 docker/.env 中写入所用 AI 服务商的密钥,三选一即可,密钥需替换为真实值。
echo "ANTHROPIC_API_KEY=sk-ant-xxxxxxxx" > docker/.env -
4启动服务
用 Docker Compose 后台启动 Bytebot 全部容器,首次运行会拉取镜像,需等待几分钟。
docker-compose -f docker/docker-compose.yml up -d -
5查看运行状态
确认容器已正常启动,检查是否有容器处于退出或反复重启状态。
docker-compose -f docker/docker-compose.yml ps
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
ANTHROPIC_API_KEY | 否 | Anthropic Claude 服务密钥,与 OpenAI、Gemini 密钥三选一 | sk-ant-xxxxxxxx |
OPENAI_API_KEY | 否 | OpenAI 服务密钥,用于驱动代理推理 | sk-xxxxxxxx |
GEMINI_API_KEY | 否 | Google Gemini 服务密钥,另一种模型后端选择 | your-gemini-key |
如何确认成功
执行 docker-compose ps 看到各服务状态为 Up,且能打开 Bytebot 的 Web 界面即表示启动成功。
常见问题
Q:必须配置 API Key 吗?
A:必须,README 明确要求加入 AI 服务商密钥,否则代理无法调用模型执行任务。可用 Anthropic、OpenAI 或 Gemini 中任意一个。
Q:不会 Docker 有更简单的部署方式吗?
A:有。README 提供 Railway 一键部署选项,点击后填入 API Key 即可,无需本地安装 Docker。
Q:企业环境如何部署?
A:可用 Kubernetes 加 Helm 部署,README 给出了 helm install 命令,详细说明见官方文档的 Helm 部署指南。
注意事项
- docker/.env 中按 README 做法只写入一个服务商的 API Key 即可
- 启动命令需在克隆后的 bytebot 目录下执行,路径为 docker/docker-compose.yml
- 首次启动需拉取镜像,耗时较长属正常现象
- 更详细的部署与使用说明请查阅官方文档 docs.bytebot.ai
核心亮点
- 容器化隔离,任务执行安全可控,不污染宿主机
- 基于视觉理解界面,不依赖特定应用 API,通用性强
- 支持自然语言多步骤任务规划,降低自动化门槛
不足之处
- 仅支持 Linux 桌面环境,Windows/macOS 用户无法直接使用
- 文档/社区待观察,生态尚在早期
适用场景
- 自动化日常办公操作,如整理文件、填写表单
- 软件测试中的 GUI 自动化操作
- 辅助残障人士通过语音/文本控制电脑
替代项目
OpenInterpreter、Self-Operating Computer、UI-TARS
上一篇:humanlayer
下一篇:prompt-master
同类项目推荐
AgentsMesh
开源
一台机器跑上百个AI编程代理,统一调度隔离管控
The AI Agent Workforce Platform. Run a hundred AI coding agents across your own mach···
loushang
开源
统一调度多模型,让 AI 编码流程可控可追踪
AI-native agent harness for coding workflows by python: multi-model LLM orchestratio···
Auto-Empirical-Research-Skills
开源
让AI帮你20分钟搞定一篇规范的实证论文
A curated collection of 23,000+ agent skills for empirical research across 8 social ···
kelos
开源
用 Kubernetes 编排 AI 编码代理,让自动化开发更可控。
Kelos - The Kubernetes-native framework for orchestrating autonomous AI coding agent···
Cybermes
开源
让 AI 智能体自动跑通漏洞挖掘与验证全流程
Autonomous Offensive Security, Bug Bounty & Red Teaming Agent Framework powered by H···
garden-desk
开源
在本地跑 AI 助手,数据不出设备
Private AI on premise
airunner
开源
本地离线跑 AI,画画聊天全搞定
Offline inference engine for art, real-time voice conversations, LLM powered chatbot···
cocoindex
开源
让智能体实时感知数据变化,增量更新上下文,告别全量重算。
Incremental engine for long horizon agents Star if you like it!
ai-jail
开源
给 AI 智能体套上沙箱,跑代码不毁机器
Multi-OS sandbox to run AI agents with better constraints (it is not 100% secure, bu···
