🏛️ Hermes
The Visual, Hierarchical AI Agent Framework
Build networks of AI agents that plan dynamically, coordinate via DAG, and never spin out of control.
git clone https://github.com/pauloberezini/hermes-synapse && cd hermes-synapse
cp .env.example .env # add your LLM API key
docker compose up -d
# Open → http://localhost:9119
✨ Why Hermes?
Most multi-agent frameworks are either too rigid (n8n: hardwired workflows) or too chaotic (AutoGen: agents talking in circles forever).
Hermes sits in the middle: a visual drag-and-drop canvas where you wire up AI agents in a strict Directed Acyclic Graph (DAG). No infinite loops. No hardcoded pipelines. Just agents that actually coordinate.
| Hermes | n8n / Make | Flowise / LangFlow | AutoGen / CrewAI |
|---|
| Execution | 🧠 Non-deterministic (AI plans dynamically) | 🔧 Deterministic (hardcoded steps) | 🔗 Visual LLM chains | 💬 Conversational loops |
| UI | 🎨 SVG canvas + isolated agent chats | Node editor | Visual chain designer | CLI / API only |
| Hierarchy | ✅ Strict DAG (cycle-safe) | ↪ Linear / conditional | Data-flow graphs | ⚠️ Free loops (cycle risk) |
| Security | 🔐 Permission Intersection | Hardcoded auth | Sandbox container | Local exec by default |
| Self-hosted | ✅ Docker, SQLite, local LLMs | ✅ | ✅ | ✅ |
📸 Demo
👆 Click to watch — canvas node wiring, Telegram integration, and live DAG planning in 3 minutes.
🚀 Quick Start
Requirements: Docker + Docker Compose. That's it.
# 1. Clone
git clone https://github.com/pauloberezini/hermes-synapse
cd hermes-synapse
# 2. Configure (only OPENROUTER_API_KEY is required — everything else is optional)
cp .env.example .env
# 3. Launch
docker compose up -d --build
# 4. Open dashboard
open http://localhost:9119
Want to use a local model (Ollama)? Set in .env:
LLM_API_BASE=http://host.docker.internal:11434/v1
LLM_MODEL=llama3
OPENROUTER_API_KEY=local # any non-empty placeholder
🏛️ Architecture
User ──→ Web Dashboard (React Canvas)
│
▼
🤖 Root Orchestrator (Jarvis) ← DAG en