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
LATEST NEWS
Hypha v1.0.1 is live.
The first stable npm line is published, documented and ready to consume from an application.
Read v1.0.1 release notes ↗01
15 npm packages
All public @codesoul-co/hypha-* libraries are aligned at v1.0.1 with exact internal versions.
↗02Built-in Skills fixed
hypha-skills now ships context-enrichment and intent-classification and exposes a resolver for their installed path.
↗03Release gates hardened
npm audit findings for js-yaml and nanoid were resolved before the patch release.
↗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
TWO WAYS TO START
Choose packages or source.
Install the versioned npm libraries inside an application, or clone the repository when you need the bundled server, complete examples and framework source.
NODE.JS 22+NPM v1.0.1TYPESCRIPTAPACHE 2.0
INSTALL THE VERSIONED PACKAGES
npm install \
@codesoul-co/hypha-core@1.0.1 \
@codesoul-co/hypha-fsm@1.0.1 \
@codesoul-co/hypha-domain@1.0.1 \
@codesoul-co/hypha-kernel@1.0.1 \
@codesoul-co/hypha-harness@1.0.1Start an application with the five foundational v1.0.1 packages. Add capability and provider packages only when your composition needs them.
Read the getting-started guide ↗A 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 →