CodeSoul-co/Hypha

git clone ... && npm ci && cp .env.example .env; needs Node 22+, MongoDB and Redis for the bundled API server

Usage

• •npm run dev to start the API server; npm run cli -- chat '...' --stream; define a DomainPack in configs/domain-packs to declare tasks, workflows, MCP, memory, policies

Key features

• ✓DomainPack declares tasks, workflows, output contracts, skills, tools, MCP, memory, context, policy, evaluation
• ✓framework-owned Harness FSM + bounded ReAct quanta with durable Event + Artifact evidence
• ✓no cache hit or provider response can authorize a side effect or advance the FSM
• ✓memory adapters: Hypha native, Mem0 OSS/Platform, Vertex AI Memory Bank
• ✓tools/MCP/skills via one governed invocation path with capability snapshots and drift control
• ✓execution adapters: local process, Docker, remote HTTP, SQLite, PostgreSQL, S3-compatible
• ✓Express API server + CLI sharing one runtime; /health and /ready traffic gate

Best for

Teams building governed, auditable agent products that must survive and recover across model calls.

Caveats

• ⚠heavier framework than a simple MCP server
• ⚠requires MongoDB + Redis for the full server
• ⚠Node.js 22+
• ⚠single-user default deployment mode