Hypha

用状态机和事件溯源把 LLM Agent 做成可回放的生产系统

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署开发框架 🍴 复刻 126 🐛 待处理 3 👀 关注 136

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 451

维护状态维护中

是否开源开源

定价模式 🏷️完全免费开源免费，无在线服务，需自行部署

项目预览

项目数据

分类开发框架

开发团队CodeSoul-co

官网地址https://codesoul-co.github.io/Hypha

GitHubhttps://github.com/CodeSoul-co/Hypha

定价模式🏷️完全免费

价格说明开源免费，无在线服务，需自行部署

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

是否开源是

开源协议Apache-2.0

主要语言TypeScript

技术栈/模型agent-framework,agent-harness,agent-memory,agent-runtime,ai-agents,cache,evaluation,event-sourcing,finite-state-machine,human-in-the-loop,llm,local-first,mcp,model-context-protocol,policy-engine,react-agent,replay,tool-use,typescript,workflow-engine

GitHub 星标★ 451

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

代码更新2026-09-04

仓库体积12.1 MB

本站数据更新2026-11-03

维护状态维护中

收录时间2026-09-16

浏览次数2

项目介绍

Hypha 是一个面向生产环境的 LLM Agent 应用开发框架，用 TypeScript 编写。它的核心理念是「Harness-oriented」，即把 Agent 的运行过程当作一个可观测、可控制的工程系统来对待，而不是简单的 prompt 拼接。框架内置有限状态机来管理 Agent 的执行流程，采用事件溯源（event-sourcing）记录每一步状态变化，让整个推理链路可回放、可调试。同时提供 Agent 记忆管理、运行时调度、缓存与评估（evaluation）等能力，帮助开发者解决 Agent 在生产中常见的状态混乱、难以复现、成本不可控等问题。它适合需要把 LLM Agent 从 demo 推向线上、对可靠性和可观测性有要求的团队，用一套结构化框架替代手写胶水代码。

Star 增长趋势

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

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

技术标签

agent-framework agent-harness agent-memory agent-runtime ai-agents

使用教程

难度：进阶约 35 分钟部署方式：本地安装 5 步

环境要求

Node.js 20+
Docker
MongoDB 与 Redis

安装与启动步骤

1拉仓库装依赖

Node 项目，装完还要起两个外部服务。
```
git clone https://github.com/CodeSoul-co/Hypha.git
```
2起文档库与缓存

它默认连本地 Mongo 与 Redis，用容器起最省事。
```
docker run -d --name hypha-mongodb -p 27017:27017 mongo:8
```

3再起缓存

Redis 用来做会话与队列。

docker run -d --name hypha-redis -p 6379:6379 redis:7-alpine

4注册一个账号并登录 CLI

先用本地账号把 CLI 打通。
```
npm run cli -- login --email owner@example.com
```
5看它暴露了哪些能力

工具、技能、工作流三类分别列一遍，比读文档快。
```
npm run cli -- tools
```