convez.ai
MCP Server
jdidjhdh

hiveflow

jdidjhdh/hiveflow

Ver no GitHub
BomPluginScore · de 0 a 100

Multi-agent coordination & HITL layer — self-hosted Studio, MCP tools, LangGraph sidecar. Alpha 0.1.x

Instalação

$npx convez-ai jdidjhdh/hiveflow

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
100%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
2

README

A tradução para o português deste README ainda está na fila.

0.1.x Alpha — Install via Docker, git source, or GitHub Release wheels (PyPI optional later) · versioning policy · docs · contribute (fork / edit docs / discussions)

HiveFlow is the multi-agent coordination and HITL layer for teams that need human approval, audited shared state, and a self-hosted ops UI — while staying compatible with runtimes like LangGraph via the sidecar pattern.

Why HiveFlow?

DifferentiatorWhat you get
Coordination layerScheduler, blackboard, HITL — use native runtime or LangGraph sidecar
Human-in-the-LoopPlan and action gates with Studio Approvals + timeout policies
Visual StudioOrchestrator, Chatflow, Analytics, Replay, HITL — self-hosted
SecurityDual input/output guards + audited, encryptable blackboard
MCP-nativeUnified tool protocol and plugin marketplace hooks

Golden Path (~5 min)

Try HiveFlow Studio in Agent mode: natural language → plan → canvas → execute. No API key required when HIVEFLOW_AGENT_ECHO_LLM=true (default in docker-compose.yml).

1. Docker (recommended)

git clone https://github.com/jdidjhdh/hiveflow.git
cd hiveflow
docker compose up --build

Open http://localhost:3000 → Orchestrator → enable Agent / real mode.

StepAction
1Enter a goal (e.g. Summarize three trends in AI agents)
2Click Plan only and review the TaskGraph
3Import to canvas → Execute DAG

APIs: POST /api/agent/plan-only · execute-plan · query — see Studio Agent cookbook (中文).

2. Library / scripts (no PyPI required)

From source (recommended for 0.1.x):

git clone https://github.com/jdidjhdh/hiveflow.git
cd hiveflow
pip install -e packages/core -e packages/agent
python examples/01_hello_hiveflow.py

Optional extras: pip install -e "packages/core[all]" (security, llm, rag, redis).

From GitHub Release wheels — download hiveflow_core / hiveflow_agent wheels from v0.1.0, then:

pip install ./hiveflow_core-*.whl ./hiveflow_agent-*.whl

PyPI (pip install hiveflow-core) will be added when published; not required for Alpha.

Advanced — embed Core engine only

For low-level control without Studio: register agents, schedule ECM tasks, read the blackboard.

import asyncio
from hiveflow import HiveFlow, HiveFlowConfig, ECM

async def main():
    hf = HiveFlow(HiveFlowConfig())
    await hf.start()
    try:
        async def handler(ecm, view):
            await view.put("result", f"Done: {ecm.intent}")
            return {"status": "ok"}

        await hf.create_agent(
            agent_id="worker",
            skills={"process"},
            read_keys=set(),
            write_keys={"result"},
            task_handler=handler,
        )
        await hf.scheduler.schedule(ECM(
            trace_id="demo-1",
            intent="Research AI trends",
            intent_id="task-1",
            emitter="user",
            required_skills=["process"],
        ))
        await asyncio.sleep(0.5)
        print(await hf.blackboard.sys_get("result"))
    finally:
        await hf.shutdown()

asyncio.run(main())

→ examples/01_hello_hiveflow.py · Core README


Features

AreaCapabilities
OrchestrationStatic/dynamic DAG, cognitive planning, 3 scheduler strategies
CollaborationEvent bus, skill-based routing, multi-agent blackboard
HITLApproval gates, plan review, Studio + WebSocket notifications
DataRAG pipeline, checkpoints (time travel), streaming SSE
ToolsMCP protocol, plugin marketplace, ReAct workers
OpsStudio UI, Prometheus analytics, trace replay

Architecture

┌─────────────────────────────────────────────────────────────┐
│                    HiveFlow Studio (Web UI)                 │
└─────────────────────────────┬───────────────────────────────┘
                              │ REST + WebSocket
┌─────────────────────────────▼───────────────────────────────┐
│                   HiveFlow Agent Runtime                     │
└─────────────────────────────┬───────────────────────────────┘
                              │
┌─────────────────────────────▼───────────────────────────────┐
│              HiveFlow Core (scheduler, HITL, RAG, MCP)       │
└─────────────────────────────────────────────────────────────┘

Details: Architecture (EN) · 架构 (ZH)


Three modules

HiveFlow is a monorepo with three packages. Pick the layer that matches your integration depth.

ModulePackageRoleTypical user
Corehiveflow · source / ReleaseOrchestration kernel — scheduler, blackboard, DAG/HITL/RAG/MCPLibrary authors, backend engineers
Agenthiveflow-agent · source / ReleaseNL planning + cognitive Skill graphs on top of CoreAgent builders, LLM app developers
Studiopackages/studio · self-hostedVisual ops UI + FastAPI backend (REST/WS)Operators, reviewers, full-stack teams

Core — packages/core (hiveflow)

The embeddable engine. You register workers with skills, schedule ECM tasks, and coordinate through a shared blackboard. Includes static/dynamic DAG orchestrators, HITL gates, checkpoints, dual guards, RAG, MCP plugin hooks, and Prometheus-friendly metrics — with no UI dependency.

  • Install: pip install -e packages/core or Release wheels · Docs: Core README · API
  • Examples: examples/01_hello_hiveflow.py … 15_multimodal_pipeline.py

Agent — packages/agent (hiveflow-agent)

The cognitive runtime on Core. HiveMindApp turns natural language into a TaskGraph, binds Skills to ReAct workers, and executes via CognitiveOrchestrator. Supports plan-only, full run_query, and execute_plan on an existing graph — with optional plan HITL before execution.

  • Install: pip install -e packages/agent or Release wheels · Docs: Agent README · Studio Agent cookbook
  • Key APIs: run_query · plan_only · execute_plan (also exposed as /api/agent/* in Studio)

Studio — packages/studio (FastAPI + React)

The visual operations platform. Orchestrator and Chatflow for workflow design; Approvals for HITL; Analytics, Tracer, and Replay for observability. The backend bridges Core DAG execution and Agent mode (HIVEFLOW_RUNTIME=agent), including LangGraph plan export.

v0.1.x preview: Studio has no built-in login. Deploy behind VPN or a reverse proxy. Electron desktop scripts are experimental and not part of release artifacts.


Documentation

ResourceEnglish中文
Documentation siteEnglishzh/
Getting Starteddocs/en/getting-started.mddocs/zh/getting-started.md
Three modulesCore · Agent · StudioCore · Agent · Studio
Cookbookdocs/en/cookbook/docs/zh/cookbook/
OSS launchOSS_LAUNCH.mddocs/zh/oss-launch.md

Project structure

HiveFlow/
├── packages/core/          # hiveflow-core — orchestration kernel (source / Release)
├── packages/agent/         # hiveflow-agent — NL cognitive runtime (source / Release)
├── packages/studio/        # Self-hosted UI + FastAPI backend
├── examples/               # 16 smoke-tested examples
└── docs/                   # MkDocs(en/ + zh/)

See Three modules above for what each layer does and when to use it.


Development

# Core tests
cd packages/core && pip install -e ".[dev]" && pytest

# Studio backend
cd packages/studio/backend && pip install -r requirements.txt -r requirements-dev.txt
HIVEFLOW_AGENT_ECHO_LLM=true pytest tests/

# Frontend
cd packages/studio/frontend && npm ci && npm run lint && npm run test:unit && npm run build

# Docs
pip install mkdocs-material "mkdocstrings[python]" mkdocs-static-i18n && pip install -e packages/core
python -m mkdocs build --strict

See CONTRIBUTING.md and GOVERNANCE.md.


Comparison

FeatureHiveFlowLangGraphCrewAIAutoGen
Dynamic orchestration✅⚠️❌⚠️
Human-in-the-Loop✅⚠️❌⚠️
Checkpoint / replay✅✅❌❌
Security guards✅❌❌❌
MCP protocol✅❌❌❌
Visual ops UI✅💰❌❌

✅ Built-in · ⚠️ Custom · ❌ N/A · 💰 Paid product


Maintainers

HiveFlow is maintained by the core team. Interested in helping? See CONTRIBUTING.md.


License

MIT — see LICENSE.

Acknowledgments

Inspired by LangGraph, CrewAI, and AutoGen · Built on MCP · Studio UI uses Ant Design and React

Ver o original no GitHub

Bom para

Relacionados