harmonist

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

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

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 2237

维护状态低维护

是否开源开源

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

项目预览

项目数据

分类智能体

开发团队GammaLabTechnologies

官网地址https://gammalab.ae

GitHubhttps://github.com/GammaLabTechnologies/harmonist

定价模式🏷️完全免费

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

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

是否开源是

开源协议MIT

主要语言Python

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

GitHub 星标★ 2237

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

代码更新2026-06-09

仓库体积2.1 MB

本站数据更新2026-11-10

维护状态低维护

收录时间2026-08-09

浏览次数6

项目介绍

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

Star 增长趋势

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

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

技术标签

agent-framework ai-agents claude-code cursor-ide llm

使用教程

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

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

环境要求

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

安装与启动步骤

1克隆仓库

把 Harmonist 拉取到本地，clone 后目录默认名为 harmonist（文档中称 <PACK_DIR>，名字可任意）。
```
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`