ThePopeBot

构建能够 24/7 全天候为您工作的自主 AI Agent，支持单兵作战或团队协作。

您将获得

24/7 全天候运行 — 设置好任务后，您的 Agent 将全天候处理，无需时刻看管。
执行实际工作 — 编写代码、发起 Pull Request、端到端完成多步骤任务。
Agent 集群 — 构建 Agent 团队，协同配合处理更大型的任务。
完全透明可控 — 每一个动作都是一次 commit，您可以随时审查、批准或撤销。

工作原理

┌──────────────────────────────────────────────────────────────────────┐
│                                                                      │
│  ┌─────────────────┐         ┌─────────────────┐                     │
│  │  Event Handler  │ ──1──►  │     GitHub      │                     │
│  │ (creates branch)│         │(agent-job/* br) │                     │
│  └────────▲────────┘         └─────────────────┘                     │
│           │                                                          │
│           │  2 (launches Docker container locally)                   │
│           │                                                          │
│           ▼                                                          │
│  ┌─────────────────┐                                                 │
│  │  Docker Agent   │                                                 │
│  │(Claude Code/Pi) │                                                 │
│  └────────┬────────┘                                                 │
│           │                                                          │
│           │  3 (commits, pushes, creates PR)                         │
│           │                                                          │
│           ▼                                                          │
│  ┌─────────────────┐                                                 │
│  │     GitHub      │                                                 │
│  │   (PR opened)   │                                                 │
│  └────────┬────────┘                                                 │
│           │                                                          │
│           │  4a (auto-merge.yml)                                     │
│           │  4b (rebuild-event-handler.yml)                          │
│           │                                                          │
│           5 (notify-pr-complete.yml →                                │
│           │  webhook to event handler)                               │
│           └──────────────────────────►  Event Handler                │
│                                                                      │
└──────────────────────────────────────────────────────────────────────┘

您可以通过 Web 聊天界面或 Telegram（可选）与您的机器人进行交互。事件处理器（Event Handler）会创建一个 agent-job 分支，并在本地启动一个包含编码 Agent 的 Docker 容器。Agent 完成工作后，会提交结果、推送代码并创建一个 PR。Auto-merge（自动合并）功能将处理后续流程。任务完成后，您会收到通知。

Star 历史

快速开始

前置要求

要求	安装
Node.js 18+	nodejs.org
npm	随 Node.js 一起安装
Git	git-scm.com
GitHub CLI	cli.github.com
Docker + Docker Compose	docker.com (安装程序需要管理员密码)
ngrok*	ngrok.com (需要免费账户 + authtoken)

*ngrok 仅在无端口转发的本地安装中需要。VPS/云部署无需此项。注册免费 ngrok 账户，并在开始设置前运行 ngrok config add-authtoken 。

两个步骤

第一步 — 构建新项目架构：

mkdir my-agent && cd my-agent
npx thepopebot@latest init

这将创建一个包含配置文件、GitHub Actions 工作流和 Agent 模板的 Next.js 项目。您无需预先创建 GitHub 仓库 —— 设置向导会自动处理。

第二步 — 运行设置向导：

npm run setup

向导将引导您完成所有配置：

检查前置要求（Node.js, Git, GitHub CLI）
创建 GitHub 仓库并推送初始 commit
创建 GitHub Personal Access Token（限定于您的仓库）
收集 API Key（必须具备 Anthropic；OpenAI, Brave 为可选）
设置 GitHub 仓库的 Secrets 和 Variables
生成 .env 文件
构建项目并为您启动 Docker

大功告成。 向导完成后，访问您的 APP_URL 即可使用。

Web 聊天：访问您的 APP_URL 进行对话。