Agent Core
Reasoning/ReAct, planning, tool selection, Memory access, model routing and context orchestration.
OPEN SOURCE · APACHE 2.0 · TYPESCRIPT
Hypha combines an Agent Core with a Production Harness so domain agents can reason, act, recover, replay and improve inside explicit boundaries.
CLONE THE OFFICIAL REPOSITORY
git clone https://github.com/CodeSoul-co/Hypha.git
cd Hypha
npm ci
cp .env.example .env
DOMAINPACKAGENT COREHARNESSEVENT EVIDENCE
TWO COOPERATING LAYERS
Reason freely. Execute with evidence.
The Agent Core decides what to do. The Production Harness turns that decision into bounded, recoverable, event-backed work.
Read the architecture →Production Harness
FSM execution, policy and approval, checkpoints, recovery, replay, audit and regression.
DomainPack
Product behavior lives in versioned task, workflow, capability, Memory, policy, evaluation and output contracts—not in framework core.
EVENT-FIRST RUNTIME
Every step leaves usable evidence.
A Run advances only when current event-derived state supports the transition. Tools, MCP, Memory and external writes pass through policy, trace and harness hooks.
CODESOUL / EVENT-FIRST STACK
One event-first path—from execution to durable evidence.
Hypha turns decisions and side effects into governed, recoverable events. Plasmod persists those events as queryable memory, state, artifacts, relations and structured evidence.
Explore Plasmod Database ↗
INCLUDED CAPABILITIES
One runtime. Explicit boundaries.
Hypha ships the contracts and reference components required to build real agent products without hiding authority in a provider SDK or an unbounded loop.
Runtime
ReAct + FSM, durable commands, continuation, timers, leases, cancellation, human review and replay.
Domain
Validated YAML, JSON or TypeScript Domain Packs, overlays, deterministic compilation and dependency snapshots.
Memory
Native, local and external Memory providers behind one governed, scoped and traceable contract.
Tools & MCP
Local, HTTP, plugin and MCP adapters through the same governed invocation path.
Execution
Provider-neutral workspace, sandbox, command, Artifact, store, recovery and cache contracts.
Cache & reuse
Serving Cache, Thinking Cache, WorkCache, semantic trees and prefix reuse without authority.
CACHE & REUSE PLANE
Reuse work. Never reuse authority.
Validated model work, reasoning structures, tool results, Memory projections and prompt prefixes can be reused. Event, Artifact, receipts and checkpoints remain the source of truth.
- A hit cannot authorize a side effect
- A hit cannot advance the FSM
- A hit cannot replace evidence
- Cache can always be bypassed or rebuilt
FOR EXPERIENCED DEVELOPERS
Clone. Configure. Run.
Use the official repository directly when you already know your system boundary. Node.js 22+, MongoDB, Redis and one model provider are the bundled server requirements.
NODE.JS 22+MONGODBREDISMODEL PROVIDER
CLONE THE OFFICIAL REPOSITORY
git clone https://github.com/CodeSoul-co/Hypha.git
cd Hypha
npm ci
cp .env.example .envA GENTLER ON-RAMP
Start with two guided Skills.
If you want help moving from a product idea to a working Hypha agent, CodeSoul Skill Garden provides a continuous two-step path.
agent-native-requirements
Turns real scenarios, inputs, outputs, risks and quality expectations into an engineering-ready specification.
hypha-domain-builder
Reads the approved requirements and builds, tests, fixes and documents a complete product on the latest Hypha source.
Open Skill Garden ↗
Experienced developers can skip the Skills and clone Hypha directly.
READ THE SOURCE, NOT A PITCH
Official docs, maintained with the source.
The website summarizes the repository; field contracts, current behavior and implementation details remain in the official source and docs.
Docs →