Fusion Agent Framework

Build agent workflows with privacy routing, RAG, and observability.

A 13-node canvas, DSL orchestration, and a six-layer runtime. Open source. Self-hosted.

Get StartedView Source
Hanflow canvas preview
Capabilities

Everything you need to ship agents.

13-node canvas

Compose Sequential, Parallel, Loop, Branch, HITL, LLM, Tool, Research, Execution, Coordinator, Memory, Subworkflow, and Knowledge nodes.

DSL orchestration

Declarative YAML with depends_on, conditions, retries, and per-node error policies. Acyclic DAG, compiled and validated.

Privacy routing

Sensitivity tiers and PII detection route regulated workloads to local models. Hard or soft enforcement.

MCP tool bus

A unified bus over stdio, sse, http, websocket, and in-process transports, with rate limiting and destructive guards.

RAG retrieval

Vector, fulltext, and hybrid search with RRF, weighted, and cascade fusion. Pluggable embeddings and rerankers.

Web Studio

Build, Monitor, and HITL modes. A live canvas, trace timeline, and approval panel with countdown.

Architecture

Six layers, one runtime.

  • L1 DeliveryREST, WebSocket, Webhooks
  • L2 OrchestrationCompiler, registry, executors
  • L3 CapabilitiesAtoms: research, execution
  • L4 FoundationModels, tools, retrieval, memory
  • L5 PersistenceCheckpoint, session, artifact
  • L6 ObservabilityTrace, metrics, logs
L1 Delivery
L2 Orchestration
L3 Capabilities
L4 Foundation
L5 Persistence
L6 Observability
Quick Demo

Running in three steps.

  1. 01

    Clone

    Get the repo and copy the example config.

    git clone https://github.com/hanflow/hanflow && cd hanflow
  2. 02

    Configure

    Set your model keys in .env.

    cp deploy/docker/hanflow.yaml.example hanflow.yaml
cp deploy/docker/.env.example .env
  3. 03

    Run

    Bring up the full stack with one command.

    cd deploy/docker && docker compose up -d

Start building.

Install
docker compose up -d
Start building.