AI-Powered Workflow Automation Platform with n8n-compatible execution engine.
VibeFlow is a comprehensive workflow automation platform featuring a visual node-based editor, n8n-compatible workflow execution engine, and real-time collaboration capabilities. Built on modern web technologies (Bun, React, TypeScript) for high performance and developer experience.
- Visual Workflow Editor - Drag-and-drop interface with real-time updates
- n8n Compatible - Execute existing n8n workflows without modification
- AI Nodes - Built-in LangChain nodes for AI agents and LLMs
- Hot Reload - Watch mode for instant development feedback
- External Nodes - Auto-load community nodes from npm
- WebSocket Sync - Real-time collaboration across multiple clients
- Git Integration - Commit workflows with AI-generated messages
- Secrets Management - Secure credential storage for workflow execution
VibeFlow consists of 5 independent services that work together:
βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ
β packages/ui ββββββΆβpackages/config ββββββΆβ packages/core β
β React UI β β Config Server β β Execution Eng. β
β Port: 7574 β β Port: 7575 β β Port: 7576 β
βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ
β β
β βΌ
β βββββββββββββββββββ
β βpackages/secrets β
β β Secrets Server β
β β Port: 7577 β
β βββββββββββββββββββ
β
ββββββββΌββββββββ
β packages/cli β
β CLI Tools β
ββββββββββββββββ
packages/ui - Visual Workflow Editor
Modern React interface for building and managing workflows.
Tech Stack: React 19, TypeScript, TailwindCSS 4, shadcn/ui, Preact Signals
Features:
- Canvas-based node editor with connection lines
- Real-time collaboration via WebSocket
- Monaco code editor for node parameters
- Git integration (commit, status, history)
- Execution monitoring and debugging
- Theme support (light/dark)
Quick Start:
cd packages/ui
bun install
bun dev # http://localhost:7574packages/config - Configuration Server
HTTP/WebSocket server for managing n8n workflow configurations.
Port: 7575 API: REST + WebSocket
Features:
- CRUD operations for workflows
- Node and edge operations (create/update/delete)
- Real-time sync via WebSocket
- Git status tracking
- Workflow validation (structure, cycles, references)
- History management (undo/redo)
- SQLite database for metadata
API Examples:
# List workflows
curl http://localhost:7575/configs
# Get workflow
curl http://localhost:7575/configs/my-workflow
# Create node
curl -X POST http://localhost:7575/configs/my-workflow/nodes \
-H "Content-Type: application/json" \
-d '{"name":"Code","type":"n8n-nodes-base.code","parameters":{}}'
# Create connection
curl -X POST http://localhost:7575/configs/my-workflow/edges/NodeA/NodeB \
-d '{"outputIndex":0,"inputIndex":0}'
# WebSocket
wscat -c ws://localhost:7575/ws
> {"type":"subscribe","workflowId":"my-workflow"}Environment:
PORT=7575
CONFIGS_DIR=./configs
DB_PATH=./data/database.dbpackages/core - Workflow Execution Engine
n8n-compatible workflow executor with support for built-in and external nodes.
Port: 7576 Runtime: Bun
Supported Node Types (15+ built-in):
- Triggers: Webhook, ExecuteWorkflowTrigger
- Control: Wait, If, Switch
- Transform: Code, SplitInBatches, SplitOut
- Actions: HTTP Request, Telegram, Markdown
- LangChain: OpenRouter LLM, Agent, VectorStore, Embeddings
- External: Auto-loads from npm (e.g.,
@brave/n8n-nodes-brave-search)
Features:
- Execute workflows via webhook triggers
- Pause/resume with Wait nodes
- Expression evaluation (
={{$json.value}}) - Real-time execution status via WebSocket/SSE
- SQLite persistence for executions
- Chunk streaming for LLM outputs
API Examples:
# List available nodes
curl http://localhost:7576/nodes
# Execute workflow via webhook
curl -X POST http://localhost:7576/webhook/my-webhook \
-H "Content-Type: application/json" \
-d '{"data":"hello"}'
# Get execution status
curl http://localhost:7576/api/executions
# WebSocket for real-time updates
wscat -c ws://localhost:7576/ws/execution
# SSE stream for agent output
curl -N http://localhost:7576/sse/execution/exec_123Environment:
PORT=7576
DATABASE_PATH=./data/vibeflow.db
CONFIG_API=http://localhost:7575
INTERNAL_API_KEY=your-shared-secretAdd External Nodes:
bun add @brave/n8n-nodes-brave-search
bun add n8n-nodes-playwright-scripts
# Automatically loaded on server startpackages/secrets - Secrets Management
Secure credential storage for workflow execution.
Port: 7577 Binding: 127.0.0.1 (localhost-only)
Security Model:
- Public API (
/api/secrets) - Returns masked values for frontend - Internal API (
/internal/secrets) - Full values for core (requiresX-Internal-Key) - Encrypted
.envfile storage
Features:
- CRUD for secrets (TELEGRAM_BOT_TOKEN, API keys)
- Masked values (
sk-β’β’β’β’β’β’β’β’xyz) for frontend - Full values for workflow execution (localhost + shared key)
API Examples:
# Public API (masked values)
curl http://localhost:7577/api/secrets
# Create secret
curl -X POST http://localhost:7577/api/secrets \
-d '{"key":"TELEGRAM_BOT_TOKEN","value":"123:abc"}'
# Internal API (full values, requires key)
curl http://localhost:7577/internal/secrets/TELEGRAM_BOT_TOKEN \
-H "X-Internal-Key: your-shared-secret"Environment:
PORT=7577
SECRETS_DIR=./user_data
INTERNAL_API_KEY=your-shared-secretpackages/cli - Command Line Tools
CLI utilities for workflow management (future).
Planned Features:
- Create/export workflows
- Run executions from terminal
- Secret management
- Backup/restore
bun installCreate .env files in each package:
packages/config/.env:
PORT=7575
CONFIGS_DIR=./configspackages/core/.env:
PORT=7576
CONFIG_API=http://localhost:7575
INTERNAL_API_KEY=change-me-in-production
TELEGRAM_BOT_TOKEN=your_token
OPENROUTER_API_KEY=your_keypackages/secrets/.env:
PORT=7577
INTERNAL_API_KEY=change-me-in-productionOpen 4 terminals:
# Terminal 1: Config Server
cd packages/config && bun dev
# Terminal 2: Execution Engine
cd packages/core && bun dev
# Terminal 3: Secrets Server
cd packages/secrets && bun dev
# Terminal 4: UI
cd packages/ui && bun devVisit: http://localhost:7574
- Runtime: Bun - Fast JavaScript runtime
- Frontend: React 19, TailwindCSS 4, shadcn/ui
- Backend: Bun.serve (HTTP + WebSocket)
- Database: SQLite (Bun native)
- State: Preact Signals, Zustand
vibeflow/
βββ packages/
β βββ ui/ # React workflow editor
β βββ config/ # Config management server
β βββ core/ # Workflow execution engine
β βββ secrets/ # Secrets management
β βββ cli/ # CLI tools (future)
βββ package.json # Workspace root
βββ CLAUDE.md # AI assistant context
All services support hot reload in development:
# Watch mode (auto-restart on file changes)
bun dev# Run tests (coming soon)
bun testCreate a workflow that:
- Receives messages via Webhook
- Processes with LangChain Agent
- Sends reply via Telegram node
- Playwright node fetches web pages
- Code node extracts data
- HTTP Request posts to API
- Wait node receives prompt
- OpenRouter LLM generates content
- Markdown node converts to HTML
- HTTP Request publishes
- Localhost-only: Secrets server binds to 127.0.0.1
- Shared Secret: Internal API requires
X-Internal-Keyheader - No Leakage: Frontend never sees full secret values
- Git-ignored:
.envfiles excluded from version control
- Support for more n8n nodes
- AI assisted workflow design
- Multi-user authentication
- Workflow templates marketplace
- Cloud deployment (Docker)
- Workflow debugging with breakpoints
- Visual execution flow with animations
- Workflow versioning and rollback
- Performance monitoring
- Plugin system for custom nodes
VibeFlow is licensed under the Elastic License 2.0.
What you CAN do:
- β Use for personal or commercial projects
- β Modify and create derivative works
- β Self-host for your organization
- β Fork and contribute back
- β Use in your products (embedded)
What you CANNOT do:
- β Offer as a hosted SaaS service to third parties
- β Provide as a managed service competing with the original
- β Remove or obscure license notices
TL;DR: Use freely, but don't create a competing hosted service.
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a pull request
For questions or issues, open a GitHub issue or contact the maintainers.
- n8n - Workflow automation platform (compatibility target)
- Node-RED - Low-code programming tool
- LangChain - AI orchestration framework
Built with β€οΈ using Bun, React, and TypeScript