Part of the ellmos-ai family.
A local-first n8n workflow manager with a visual graph viewer, REST API, CLI, and multi-server sync in one Python package.
Manage, visualize, document, and move n8n workflows across multiple servers from a single dashboard.
| You want to... | Use this |
|---|---|
| inspect local n8n workflow exports | Dashboard and visual workflow viewer |
| document workflows for handoff or review | Markdown export and API docs |
| sync workflows between multiple n8n servers | Server registry, pull, and push commands |
| let agents create workflow drafts | /api/workflows/build endpoint |
| install n8n on a remote Docker host | n8n-manager setup |
- Visual Workflow Viewer -- Interactive graph visualization powered by vis.js. Zoom, pan, click nodes for details.
- Web Dashboard -- Overview of all workflows with status, tags, and quick actions.
- Workflow Editor -- Add, connect, and configure nodes in-browser with drag-and-drop.
- Multi-Server Management -- Connect to multiple n8n instances. Push/pull workflows between them.
- REST API + Swagger -- Full CRUD API with auto-generated documentation at
/docs. - CLI -- Manage workflows from the terminal: import, export, push, pull, list, and more.
- Duplicate Detection -- Content-hash based deduplication prevents importing the same workflow twice.
- Version History -- Track changes to workflows over time with automatic versioning.
- Workflow Builder API -- Programmatically create workflows via POST request (great for AI agents).
- Remote n8n Setup -- Install n8n on remote servers via SSH + Docker with a single command.
- JSON + Markdown Export -- Export workflows as clean JSON or human-readable Markdown documentation.
- Workflow Templates -- Pre-built templates for common automation patterns.
Install directly from GitHub (PyPI release pending):
pip install git+https://github.com/ellmos-ai/n8n-workflow-manager.gitOr clone for development:
git clone https://github.com/ellmos-ai/n8n-workflow-manager.git
cd n8n-workflow-manager
pip install -e .# Start the web UI + API server
n8n-manager serve
# Open in browser: http://localhost:8100
# Swagger API docs: http://localhost:8100/docs# Import a workflow from JSON file
n8n-manager import my-workflow.json
# List all workflows
n8n-manager list
# Export as Markdown documentation
n8n-manager export 1 --format md
# Add an n8n server
n8n-manager servers --add production https://n8n.example.com:5678 YOUR_API_KEY --default
# Push workflow to server
n8n-manager push 1
# Pull all workflows from server
n8n-manager pull
# Check system status
n8n-manager status
# Install n8n on a remote server
n8n-manager setup --host 1.2.3.4 --ssh-key ~/.ssh/id_ed25519docker-compose up -d
# Open http://localhost:8100The /api/workflows/build endpoint allows programmatic workflow creation:
curl -X POST http://localhost:8100/api/workflows/build \
-H "Content-Type: application/json" \
-d '{
"name": "My Workflow",
"nodes": [
{"type": "n8n-nodes-base.webhook", "name": "Trigger", "parameters": {"path": "/hook"}},
{"type": "n8n-nodes-base.httpRequest", "name": "Fetch", "parameters": {"url": "https://api.example.com"}}
],
"connections": [{"from_node": "Trigger", "to_node": "Fetch"}]
}'Full API documentation available at /docs (Swagger UI) when the server is running.
n8n-workflow-manager/
├── core/ # Config, Database, Parser, n8n Client, Builder
├── api/ # FastAPI server + REST routes
├── web/ # Jinja2 templates + vis.js frontend
├── setup/ # SSH helper + n8n Docker installer
├── export/ # JSON, Markdown export
├── templates/ # Pre-built workflow templates
├── data/ # SQLite database (auto-created)
└── docs/ # Documentation
| Component | Technology |
|---|---|
| Backend | Python 3.10+ / FastAPI / Uvicorn |
| Frontend | Jinja2 / vis.js (CDN) / Vanilla JS |
| Database | SQLite (WAL mode) |
| n8n Client | httpx |
| Remote Setup | SSH + Docker |
| Color | Category | Examples |
|---|---|---|
| Orange | Trigger | Webhook, Schedule, Manual |
| Blue | Processing | HTTP Request, Code, Set |
| Yellow | Logic | IF, Switch, Merge |
| Purple | AI | LangChain Agent, LLM Chain |
| Green | Action | Email, Slack, Telegram |
# Show current config
n8n-manager config --show
# Change API port
n8n-manager config --set api_port 9000Configuration is stored in config.json. Key settings:
| Key | Default | Description |
|---|---|---|
api_port |
8100 | Web UI / API port |
db_path |
data/n8n_manager.db |
SQLite database path |
default_server |
null | Default n8n server name |
Install n8n on any Linux server with Docker:
n8n-manager setup --host your-server-ip --ssh-key ~/.ssh/id_ed25519
# After installation:
# 1. Open http://your-server-ip:5678 in browser
# 2. Create n8n account
# 3. Go to Settings > API > Create API Key
# 4. Register in n8n-manager:
n8n-manager servers --add myserver http://your-server-ip:5678 YOUR_API_KEY --defaultAn MCP (Model Context Protocol) server is available as a separate package for AI-powered workflow management:
npm install -g n8n-manager-mcpSee n8n-manager-mcp for details.
For LLM agents, crawlers, and directory listings, see llms.txt. It summarizes the canonical repository, package purpose, useful keywords, related ellmos-ai projects, and verification commands.
Contributions are welcome! Please read CONTRIBUTING.md for guidelines.
MIT License - see LICENSE for details.
- n8n -- The workflow automation platform
- vis.js -- Network visualization library
- FastAPI -- Modern Python web framework
Dieses Projekt ist eine unentgeltliche Open-Source-Schenkung im Sinne der §§ 516 ff. BGB. Die Haftung des Urhebers ist gemäß § 521 BGB auf Vorsatz und grobe Fahrlässigkeit beschränkt. Ergänzend gelten die Haftungsausschlüsse aus GPL-3.0 / MIT / Apache-2.0 §§ 15–16 (je nach gewählter Lizenz).
Nutzung auf eigenes Risiko. Keine Wartungszusage, keine Verfügbarkeitsgarantie, keine Gewähr für Fehlerfreiheit oder Eignung für einen bestimmten Zweck.
This project is an unpaid open-source donation. Liability is limited to intent and gross negligence (§ 521 German Civil Code). Use at your own risk. No warranty, no maintenance guarantee, no fitness-for-purpose assumed.