bytebot

用大白话指挥电脑干活,自动完成重复操作

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开源模型 🍴 复刻 1511 🐛 待处理 73 👀 关注 2 ⚠️ 作者已归档(停止维护)
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 11066
维护状态 低维护
是否开源 开源
定价模式 🏷️完全免费 开源项目,Apache-2.0 许可证,可自行部署,完全免费。

项目预览

bytebot 项目界面预览图
图片来源:项目官网

项目数据

分类开源模型
开发团队bytebot-ai
定价模式🏷️完全免费
价格说明开源项目,Apache-2.0 许可证,可自行部署,完全免费。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议Apache-2.0
主要语言TypeScript
技术栈/模型agent,agentic-ai,agents,ai,ai-agents,ai-tools,anthropic,automation,bytebot,computer-use,computer-use-agent,cua,desktop,desktop-automation,docker,gemini,llm,mcp,openai
GitHub 星标★ 11066
上线时间2025-02-03 00:00:00
代码更新2025-09-12
仓库体积18.6 MB
本站数据更新2026-11-09
维护状态低维护
收录时间2026-08-09
浏览次数6

项目介绍

Bytebot 是一个自托管的 AI 桌面代理,通过自然语言指令自动执行计算机任务,运行在容器化的 Linux 桌面环境中。它解决了传统自动化脚本难以适应复杂、动态界面操作的问题,让用户可以用日常语言描述意图,由 AI 代理理解并操作鼠标、键盘和屏幕,完成文件管理、网页浏览、软件操作等任务。核心能力包括:基于视觉的界面理解、自然语言到操作序列的转换、容器化隔离执行环境、可扩展的插件机制,以及支持多步骤任务规划。项目采用 TypeScript 编写,强调安全性和可控性,用户可完全掌控运行环境。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 11066

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:入门 约 10 分钟 部署方式:Docker 5 步

环境要求

  • 安装 Docker 与 Docker Compose
  • 准备 AI 服务商的 API Key(如 ANTHROPIC_API_KEY、OPENAI_API_KEY 或 GEMINI_API_KEY)
  • 可访问 GitHub 与容器镜像仓库的网络环境
  • 本地需预留运行容器化 Linux 桌面的资源

安装与启动步骤

  1. 1克隆仓库

    从 GitHub 拉取 bytebot 源码到本地,后续所有 Docker 配置都在该目录下操作。

    git clone https://github.com/bytebot-ai/bytebot.git
  2. 2进入项目目录

    切换到克隆下来的 bytebot 目录,确认能看到 docker 子目录。

    cd bytebot
  3. 3写入 API Key

    在 docker/.env 中写入所用 AI 服务商的密钥,三选一即可,密钥需替换为真实值。

    echo "ANTHROPIC_API_KEY=sk-ant-xxxxxxxx" > docker/.env
  4. 4启动服务

    用 Docker Compose 后台启动 Bytebot 全部容器,首次运行会拉取镜像,需等待几分钟。

    docker-compose -f docker/docker-compose.yml up -d
  5. 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···

★ 2362 2026-08-09
loushang 开源

统一调度多模型,让 AI 编码流程可控可追踪

AI-native agent harness for coding workflows by python: multi-model LLM orchestratio···

★ 2023 2026-08-09
Auto-Empirical-Research-Skills 开源

让AI帮你20分钟搞定一篇规范的实证论文

A curated collection of 23,000+ agent skills for empirical research across 8 social ···

★ 4961 2026-08-09
kelos 开源

用 Kubernetes 编排 AI 编码代理,让自动化开发更可控。

Kelos - The Kubernetes-native framework for orchestrating autonomous AI coding agent···

★ 356 2026-08-09
Cybermes 开源

让 AI 智能体自动跑通漏洞挖掘与验证全流程

Autonomous Offensive Security, Bug Bounty & Red Teaming Agent Framework powered by H···

★ 1011 2026-09-13
garden-desk 开源

在本地跑 AI 助手,数据不出设备

Private AI on premise

★ 248 2026-11-05
airunner 开源

本地离线跑 AI,画画聊天全搞定

Offline inference engine for art, real-time voice conversations, LLM powered chatbot···

★ 1318 2026-08-09
cocoindex 开源

让智能体实时感知数据变化,增量更新上下文,告别全量重算。

Incremental engine for long horizon agents Star if you like it!

★ 11836 2026-08-09
ai-jail 开源

给 AI 智能体套上沙箱,跑代码不毁机器

Multi-OS sandbox to run AI agents with better constraints (it is not 100% secure, bu···

★ 1494 2026-10-11