Skip to content
alex-mextnerPublic

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

VibeFlow

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.

🎯 Key Features

  • 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

πŸ—οΈ Architecture

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 Overview

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:7574

packages/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.db

packages/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_123

Environment:

PORT=7576
DATABASE_PATH=./data/vibeflow.db
CONFIG_API=http://localhost:7575
INTERNAL_API_KEY=your-shared-secret

Add External Nodes:

bun add @brave/n8n-nodes-brave-search
bun add n8n-nodes-playwright-scripts
# Automatically loaded on server start

packages/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 (requires X-Internal-Key)
  • Encrypted .env file 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-secret

packages/cli - Command Line Tools

CLI utilities for workflow management (future).

Planned Features:

  • Create/export workflows
  • Run executions from terminal
  • Secret management
  • Backup/restore

πŸš€ Quick Start

1. Install Dependencies

bun install

2. Configure Environment

Create .env files in each package:

packages/config/.env:

PORT=7575
CONFIGS_DIR=./configs

packages/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_key

packages/secrets/.env:

PORT=7577
INTERNAL_API_KEY=change-me-in-production

3. Start All Services

Open 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 dev

4. Open Browser

Visit: http://localhost:7574


πŸ“š Documentation


πŸ› οΈ Development

Tech Stack

  • 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

Project Structure

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

Hot Reload

All services support hot reload in development:

# Watch mode (auto-restart on file changes)
bun dev

Testing

# Run tests (coming soon)
bun test

🎯 Use Cases

1. Telegram Bot with AI

Create a workflow that:

  1. Receives messages via Webhook
  2. Processes with LangChain Agent
  3. Sends reply via Telegram node

2. Web Scraping Pipeline

  1. Playwright node fetches web pages
  2. Code node extracts data
  3. HTTP Request posts to API

3. AI Content Generation

  1. Wait node receives prompt
  2. OpenRouter LLM generates content
  3. Markdown node converts to HTML
  4. HTTP Request publishes

πŸ”’ Security

  • Localhost-only: Secrets server binds to 127.0.0.1
  • Shared Secret: Internal API requires X-Internal-Key header
  • No Leakage: Frontend never sees full secret values
  • Git-ignored: .env files excluded from version control

πŸ—ΊοΈ Roadmap

  • 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

πŸ“„ License

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.


🀝 Contributing

Contributions are welcome! Please:

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

For questions or issues, open a GitHub issue or contact the maintainers.


πŸ”— Related Projects

  • n8n - Workflow automation platform (compatibility target)
  • Node-RED - Low-code programming tool
  • LangChain - AI orchestration framework

Built with ❀️ using Bun, React, and TypeScript

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages