Takuto Core 概览
Takuto Core 是一套按你节奏运转的自托管 AI 编码流水线。把它指向 Jira 或 GitHub Issues，让它自主运行 —— 领取工单、创建分支、写代码、跑测试、提交 pull request —— 或由你亲自掌舵，从仪表盘逐个触发各阶段。每个 workflow 都跑在自己的 Docker container 里，背后有 egress 防火墙把守，运行在你掌控的硬件上。
Beta。 Takuto Core 正处于活跃的 beta 阶段。它今天就能用，但难免有粗糙之处 —— 也欢迎你发来反馈。每一份报告都在帮助塑造项目的走向。
你能用它做什么
- 全自动模式 —— 接上 Jira 或 GitHub Issues，Takuto 便会自动轮询：领取 “To Do” 工单，跑完整条流水线（worktree → 安装 → 实现 → lint/测试 → PR），再处理 下一个。
- 手动模式，你的节奏 —— 自己把任意工单或任务加到仪表盘，在 agent 看到之前借助 AI 打磨它的描述，然后在你准备好时逐个触发 workflow 的各阶段。
- 两者兼有 —— 自动领取常规活儿，同时手动打理棘手的工单。
- 并行处理工单 —— 每个 workflow 都有独立的 git worktree 和隔离环境；并发数由你 决定。
- 实时监控 —— 实时仪表盘按 workflow 输出终端日志，并让你暂停、恢复、重试或检视 任意一次运行。
- 定义你自己的流水线 —— 把各阶段（实现 → 评审 → 测试 → PR → 合并 base）连同依赖 关系串联起来，在仪表盘的 Workflows 标签页里编辑。附带的 TOML 文件为新 workspace 播种默认值。
- 无需工单系统也能用 —— 把描述粘贴进仪表盘，Takuto 就当作一个 workflow 来 处理。无需 Jira 账号。
它与 IDE 助手有何不同
| IDE 助手（Copilot、内联 Cursor） | Takuto Core | |
|---|---|---|
| 运行位置 | 在你的编辑器里，在你的机器上 | 在 Docker 里，在任意机器或服务器上 |
| 监管方式 | 你逐步批准 | 自主或手动触发 —— 由你选择 |
| 工单系统 | 无 | Jira、GitHub Issues，或独立运行 |
| 流水线 | 单条 prompt | 多步骤 TOML：实现、评审、测试、PR |
| 并发 | 一次一个任务 | 多个工单并行 |
| 安全边界 | 可完全访问互联网 | egress 防火墙 —— 仅可访问已批准的主机 |
| 团队部署 | 仅限单个开发者 | 自托管在服务器上；共享仪表盘 |
| 持久性 | 关闭编辑器即结束 | 重启后依然存活；暂停的 workflow 可恢复 |
运行它的两种方式
有两条受支持的路径。挑一条与你所需掌控程度相匹配的。
1. Takuto CLI（推荐用于快速上手）
配套的 Takuto CLI 替你生成配置并编排 Docker Compose。从一个空目录
起步，几分钟内就能得到一个运行中的仪表盘：安装 CLI，运行 takuto setup（它会在当前目录
创建一个 .takuto/ 文件夹），再运行 takuto start 把它启动起来并打开仪表盘 —— 余下的
设置（admin 账号、AI 提供商、GitHub）都在那里完成。这是在单个项目上试用 Takuto Core
最快的方式。
→ 从 快速上手 开始。
2. 基于 Takuto Core 自建 container
如果你想要完全的掌控 —— 服务器部署、定制镜像、前置反向代理 —— 就从
https://github.com/takuto-team/takuto-core 克隆 Takuto Core 引擎，直接用 Docker Compose 运行它。
config.toml、构建和部署都由你自己管理。
→ 参见 安装 Takuto Core。
两条路径跑的是同一个 Takuto Core 引擎和同一个仪表盘。CLI 只是 Compose 配置之上的 一层便利封装。
前置条件
开始之前，请准备好这些：
- Docker（或 Podman）以及
docker compose—— 推荐 Docker 24+ / Podman 4+。 Takuto CLI 会自动识别你装的是哪一个。 - 内存： 单个 workflow ≥ 8 GiB；在 macOS 上用 Podman 时 ≥ 12 GiB（Podman VM 需要
分走自己的一份）。把
[general] max_concurrent_workflows调到与你机器相称。 - 磁盘： ≥ 30 GiB 可用空间。worktree、npm/cargo 缓存、mise 工具链，以及可选的 Docker-in-Docker 存储层都存放在 Docker 卷里。
- 一个 GitHub 账号和 token —— 细粒度个人访问令牌（PAT）或一个配置好的 GitHub App。
参见 配置 →
[github]。 - 一个 AI 提供商账号 —— Claude Code（Anthropic API key、Pro/Max OAuth 或企业代理）、 Cursor Agent、Codex，或通过 OpenCode 接入的自托管模型。
- （可选）Atlassian 访问权限 —— 仅在
ticketing_system = "jira"时需要。
服务器部署推荐使用 Linux 主机；macOS 在本地使用时表现良好。
许可一览
- Takuto Core（引擎）在 AGPL-3.0 下开源。自托管是免费的；如果 AGPL 的条款不 符合你的需求，欢迎通过 morphet.contact@gmail.com 联系。
- Takuto CLI 采用 MIT 许可。
关于许可、成本、隐私和 beta 状态的详情，参见 FAQ。