takt

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

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

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1385

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队nrslib

所属国家

官网地址

GitHubhttps://github.com/nrslib/takt

定价模式free

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

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

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

GitHub 星标★ 1385

30天Star增速

HF 下载量

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

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数1

使用教程

难度：入门约 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//。

常见问题

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// 下。
README 节选中未给出启动工作流的命令，请以仓库 docs 教程为准，不要臆测参数。

核心亮点

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

不足之处

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

适用场景

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

替代项目

CrewAI、LangGraph、AutoGen

项目介绍

takt 是智能体领域的开源项目，由 nrslib 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,385）位列前 30%，在智能体分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,283 增加到 1,385，净增 102。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。MIT许可证，可免费使用和部署。

它主要面向的使用场景是：多智能体协作完成复杂软件开发任务。同类可对比的替代方案包括 CrewAI、LangGraph、AutoGen。

上一篇：hermes-ecosystem

下一篇：octomind