Favicon of Hypha

Hypha

A self-hosted TypeScript AI agent framework provides policy-controlled tool use, recoverable workflows and local storage adapters under Apache 2.0.

Screenshot of Hypha website

Hypha is a TypeScript AI agent framework for developers building applications that need controlled tool use and recoverable work. It separates an agent's planning and tool choices from the execution layer that decides which actions may proceed.

  • Policy and human review: Apply policies, approvals and execution boundaries to tool calls, MCP integrations, memory operations and external writes.
  • Recoverable workflows: Use checkpoints, cancellation and recovery workers to manage long-running tasks, with recorded events supporting replay, audits and evaluation.
  • Reusable application definitions: Define tasks, prompts, workflows and output contracts in Domain Packs so different agent applications can share the runtime while retaining their own capabilities and policies.
  • Local and remote adapters: Use SQLite, local files, local processes or Docker, with adapters for remote execution and storage when an application needs them.
  • Validated reuse: Reuse eligible model responses, reasoning and tool results through caches whose contents can't authorize actions or replace execution records.

Hypha provides an Express API server and an example CLI. Applications supply their own prompts, workflows, policies and deployment choices; it's a framework rather than a ready-made chat app.

Memory options include local Native Lite and self-hosted Mem0 OSS. Mem0 Platform and Vertex AI Memory Bank are cloud alternatives. Local storage and execution adapters don't determine where model inference runs. Hypha requires Node.js 22 or later and is open source under the Apache 2.0 license.

Similar to Hypha