harmonist

零依赖编排 186 个智能体，机械协议强制，即插即用

Harmonist 是一个便携式 AI 智能体编排框架，核心特点是机械化的协议强制机制。它内置了 186 个预定义智能体，覆盖多种任务场景，并强调零运行时依赖，即部署时无需额外安装依赖库，降低了环境配置成本。该项目解决的核心问题是多智能体协作时的流程一致性和协议遵守问题，通过将协议规则机械地嵌入编排层，减少智能体行为偏差。其核心能力包括智能体编排、协议强制执行、任务分解与分配，以及轻量级集成，可无缝对接 Claude Code、Cursor IDE 等主流 AI 工具。Harmonist 适用于需要严格流程控制的企业级 AI 应用、复杂任务自动化以及多智能体系统研究，尤其适合对稳定性和可移植性要求高的场景。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2258

维护状态低维护

是否开源是

定价模式 free

项目数据

分类智能体

开发团队GammaLabTechnologies

所属国家

官网地址https://gammalab.ae

GitHubhttps://github.com/GammaLabTechnologies/harmonist

定价模式free

价格说明MIT 许可证开源，完全免费，可自行部署使用。

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型agent-framework,agent-system,ai-agents,claude-code,cursor-ide,llm,multi-agent-framework,orchestration,prompt-engineering,python

GitHub 星标★ 2258

30天Star增速

HF 下载量

上线时间2026-04-23 00:00:00

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

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数5

使用教程

难度：入门约 10 分钟部署方式：本地安装 5 步

环境要求

Python（纯标准库，无需额外依赖；POSIX 下可选 .sh 脚本）
Windows / macOS / Linux 原生运行，Windows 无需 WSL 或 Git Bash
Git（用于克隆仓库）
无需 npm、Docker、LangChain 或向量数据库

安装与启动步骤

1克隆仓库

把 Harmonist 拉取到本地，clone 后目录默认名为 harmonist（文档中称，名字可任意）。
```
git clone https://github.com/GammaLabTechnologies/harmonist.git
```
2阅读集成说明

打开仓库内的 integration-prompt.md，按其中列出的步骤完成集成；被要求安装集成的 AI 智能体也应先读它。
3区分模板与规则

AGENTS.template.md 只是模板，不要把它当作 pack 目录内的实时规则生效；它会在集成时变成用户项目的 AGENTS.md。
4在目标项目生成 AGENTS.md

按集成流程把模板落地到你自己的项目根目录，生成的文件名为 AGENTS.md，作为该项目的协议入口。
5确认运行环境

确认本机 Python 可用；Windows 上使用 py -3 或 python，POSIX 上使用 python3，钩子运行时为 hook_runner.py。

关键配置

配置项	必填	说明	示例
`AGENTS.md`	是	集成过程中在用户项目里生成的协议入口文件，承载强制执行的规则。	`AGENTS.md`
`.cursor/hooks.json`	否	由 upgrade.py 渲染生成的 Cursor 钩子配置，启动器按宿主系统选择。	`.cursor/hooks.json`
`MANIFEST.sha256`	否	供应链校验清单，用于检查每个交付文件是否完整未被改动。	`MANIFEST.sha256`

如何确认成功

集成后你的项目根目录出现 AGENTS.md；代码变更回合若未通过审查、记忆更新或供应链校验，该回合不会完成。

常见问题

Q：需要安装依赖吗？

A：不需要。项目零运行时依赖，不用 npm、Docker、LangChain 或向量数据库，仅用 Python 标准库，POSIX 的 .sh 脚本为可选项。

Q：Windows 上能直接跑吗？

A：可以。Windows、macOS、Linux 均原生运行，不需要 WSL 或 Git Bash；Windows 上强制运行时走纯 Python 的 hook_runner.py。

Q：可以直接把 AGENTS.template.md 当规则用吗？

A：不要。它只是模板，不应在 pack 文件夹内作为实时规则；集成时它才被转成用户项目的 AGENTS.md。

Q：能接入哪些 AI 工具？

A：可对接 Cursor、Claude Code、Copilot、Windsurf、Aider 等主流 AI 编码助手。

注意事项

本教程仅依据 README 节选整理，Quick start 的完整命令请以仓库内文档为准。
README 提到的钩子有两套实现：POSIX .sh 与跨平台的 Python hook_runner.py，修改前先确认你所在系统的启用路径。
.gitattributes 将换行固定为 eol=lf，Windows 检出时不要改动，否则可能破坏 MANIFEST.sha256 校验。

核心亮点

内置 186 个预置智能体，开箱即用，覆盖广泛任务场景
零运行时依赖，部署简单，环境迁移成本极低
机械协议强制机制，确保多智能体协作不偏离既定规则

不足之处

文档/社区待观察
项目较新，生态成熟度可能不及老牌编排框架

适用场景

企业级多智能体流程自动化，需严格合规控制
快速搭建 AI 代理工作流，希望避免复杂依赖管理
在 IDE 环境中集成智能体协作，提升开发效率

替代项目

AutoGen、LangGraph、CrewAI

项目介绍

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

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

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-23。MIT 许可证开源，完全免费，可自行部署使用。

它主要面向的使用场景是：企业级多智能体流程自动化，需严格合规控制。同类可对比的替代方案包括 AutoGen、LangGraph、CrewAI。

上一篇：hive

下一篇：Director