takt

用 YAML 定义 AI 团队协作拓扑，让多智能体干活有章法

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 119 🐛 待处理 56 👀 关注 5

GitHub ↗

GitHub 星标 ★ 1444

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，可免费使用和部署。

项目预览

项目数据

分类智能体

开发团队nrslib

GitHubhttps://github.com/nrslib/takt

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，可免费使用和部署。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型agent-orchestration,agent-team,ai-agents,claude-code,codex,multi-agent,opencode

GitHub 星标★ 1444

上线时间2026-01-25 00:00:00

代码更新2026-11-09

仓库体积47.7 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数2

项目介绍

TAKT 是一个用 TypeScript 编写的智能体编排框架，通过 YAML 配置文件定义 AI 智能体之间的协作拓扑、人类干预节点以及记录内容。它解决了多智能体协作中缺乏清晰结构和可控性的问题，让开发者能够以声明式的方式描述智能体团队的组织方式、任务分配和交互规则。核心能力包括：基于 YAML 的拓扑定义、灵活的协调策略、人类介入点设置、以及执行日志记录。TAKT 支持与 Claude Code、Codex 和 OpenCode 等主流智能体工具集成，适用于复杂任务拆解、多角色协作和自动化工作流等场景。其设计强调透明性和可观测性，帮助团队更好地管理和审计 AI 智能体的行为。

Star 增长趋势

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

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

技术标签

agent-orchestration ai-agents claude-code codex multi-agent

使用教程

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

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

Node.js 与 npm 环境（用于 npm install -g takt）
外部 CLI provider（如 Claude Code、Codex、OpenCode）、git、gh 或 glab 需已安装并在 PATH 中（使用 CLI
或改用 API Key 直连方式：claude-sdk、Codex、OpenCode、Pi、DeepSeek Harness（需装好其 Python SDK/运
可选：已安装 Nix（使用 flake 安装方式）

安装与启动步骤

1安装 TAKT CLI

用 npm 全局安装 takt 命令；这是 README 给出的主要安装方式，安装后可在终端直接调用。
```
npm install -g takt
```
2Nix 方式安装

已使用 Nix 的用户可通过 flake 安装或直接运行；Nix 包只装 TAKT CLI 本体，外部 provider 仍需另行安装。
```
nix profile install github:nrslib/takt
```
3创建基础配置

在 ~/.takt/config.yaml 写最小配置：provider、model、language。model 会原样传给 provider。
4配置 API 密钥

不安装外部 CLI 时，可直接导出对应厂商的环境变量，例如 Anthropic、OpenAI、OpenCode 等。
```
export TAKT_ANTHROPIC_API_KEY=sk-ant-xxxxxxxx
export TAKT_OPENAI_API_KEY=sk-xxxxxxxx
export TAKT_OPENCODE_API_KEY=your-opencode-key
```
5使用 runtime.yaml

把 provider/model/选项/自动路由移到 ~/.takt/runtime.yaml 或项目内 .takt/runtime.yaml，项目层优先。
6开启决策记录

如需把自动路由决策以 NDJSON 记录到 .takt/events/，必须显式开启；TAKT 不会上传这些数据。
```
takt telemetry enable
```

关键配置

配置项	必填	说明	示例
`provider`	是	选择使用的智能体提供方	`claude`
`model`	是	模型名，会直接传给所选 provider	`sonnet`
`language`	否	语言设置，仅支持 en 或 ja	`en`
`companion.enabled`	否	在 runtime.yaml 顶层开启伴生评审，默认关闭	`true`

如何确认成功

npm 安装无报错即可；README 未给启动命令，可确认 ~/.takt/config.yaml 生效、运行产物写入 .takt/runs/<run>/。

常见问题

Q：不安装 Claude Code 等外部 CLI 能用吗？

A：可以。claude-sdk、Codex、OpenCode、Pi 及装了 Python SDK/运行时的 DeepSeek Harness 可直接用环境变量里的凭据，无需安装对应 CLI。

Q：用 Nix 安装后还需要准备什么？

A：Nix 包只安装 TAKT CLI 本体，外部 CLI provider、git 以及 gh/glab 仍需自行安装并加入 PATH，或按 README 的 Requirements 单独配置。

Q：runtime.yaml 能和 config.yaml 的 provider 混用吗？

A：不能。runtime.yaml 中激活的 provider 段与旧版 provider 键混用会被拒绝，并给出文件名与需迁移的键的提示。

Q：为什么 companion 评审没有生效？

A：伴生评审默认关闭，需在 runtime.yaml 顶层设置 companion.enabled: true；全局与项目策略按逻辑与合并，全局 false 无法被项目层重新开启。

Q：自动路由决策会被上传吗？

A：不会。路由决策只以 NDJSON 形式记录在本地 .takt/events/，且需要 takt telemetry enable 或配置 telemetry.routing_decisions 才启用。

注意事项

runtime 模式由是否激活 provider 段决定，而不是由该文件是否存在决定。
同一目录下项目层 .takt/runtime.yaml 的优先级高于全局 ~/.takt/runtime.yaml。
运行元数据、会话、追踪与报告都以普通文件形式保存在 .takt/runs/<run>/ 下。
README 节选中未给出启动工作流的命令，请以仓库 docs 教程为准，不要臆测参数。

核心亮点

YAML 声明式配置，上手快，无需写复杂代码
支持多种主流智能体（Claude Code、Codex 等）集成
内置人类干预节点，关键步骤可人工把关

不足之处

项目较新，文档和生态还在完善中
仅支持 YAML 配置，灵活性可能受限

适用场景

多智能体协作完成复杂软件开发任务
需要人工审核关键决策的自动化流程
团队统一管理 AI 智能体行为规范

替代项目

CrewAI、LangGraph、AutoGen

上一篇：hermes-ecosystem

下一篇：octomind