# hanflow

**Repository Path**: easy-es/hanflow

## Basic Information

- **Project Name**: hanflow
- **Description**: Hanflow（Harmony AI Nexus）是一款高可控、YAML 驱动的 Agent 框架，具备自主进化能力, 基于 LangGraph 构建。它将隐私模型路由、RAG 检索、人机协同审批、全链路可观测作为一等公民设计——而非事后补丁。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 0
- **Created**: 2026-06-30
- **Last Updated**: 2026-07-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Hanflow

> Harmony AI Nexus - a fusion agent framework with privacy routing, RAG, and observability as first-class citizens.

> Home https://www.hanflow.icu

## Quick Start

```bash
# 1. Clone and configure
git clone <repo>
cd hanflow
cp deploy/docker/hanflow.yaml.example hanflow.yaml
cp deploy/docker/.env.example .env
# Fill in API keys in .env

# 2. Start all services
cd deploy/docker
docker compose up -d

# 3. Access
# Web Studio: http://localhost:3000
# API: http://localhost:8000
# API docs: http://localhost:8000/docs
```

## Architecture

6-layer architecture: L1 Delivery (CLI + Web Studio + SDK) / L2 Orchestration (YAML DSL to LangGraph) / L3 Capabilities (Research + Execution atoms) / L4 Foundation (GraphRuntime / ModelRouter / MCPBus / FilesystemMemory) / L5 Persistence (3 Stores) / L6 Observability (LangSmith trace).

## Web Studio

Three modes:
- **Build Mode**: Drag-and-drop visual workflow editor (React Flow canvas + schema-driven Inspector)
- **Monitor Mode**: Real-time run monitoring with WebSocket streaming + trace replay
- **HITL Approvals**: Human-in-the-loop approval panel with timeout countdown

## Develop

```bash
make install   # uv sync
make test     # pytest + frontend tests
make serve    # start engine at :8000

# Frontend dev
cd web && npm install && npm run dev
```

## Features

- 13 primitive node types
- 6 model routing strategies including privacy routing
- MCP tool bus
- Vector + full-text retrieval
- DSL is the single source of truth (YAML, git-versionable)

## License

MIT/Apache-2.0