Local automation. Zero cloud. Full control.
ForgeFlow is a privacy-first desktop automation engine that lets you build visual automations, run AI-powered actions, and keep your data 100% on-device.
- 🎨 Visual Automation Builder - Node-based editor like n8n, with drag & drop
- 🤖 AI-Native - First-class AI actions (summarize, classify, extract, generate)
- 🔒 Privacy-First - All data stays local, no cloud required
- ⚡ Fast & Lightweight - Built with Go + React, minimal resource usage
- 🌙 Dark Mode - Beautiful dark UI by default
- 🌍 Community Templates - Browse and share workflows at ForgeFlow-community
- Go 1.21+
- Node.js 20+
- Wails CLI
# Clone the repo
git clone https://github.com/YOUR_USERNAME/ForgeFlow.git
cd ForgeFlow
# Run in development mode (hot reload)
wails dev
# Frontend only development
cd frontend && npm run dev
# Type check frontend
cd frontend && npx tsc --noEmit
# Go build check
go build# Build production binary
wails build
# Frontend build only
cd frontend && npm run buildThe binary will be in build/bin/.
To update the app version:
- Edit
version.jsonand change the version number - Run
node scripts/sync-version.js
This automatically updates:
wails.json(productVersion)frontend/package.json(version)app.go(version string)build/splash.html(version display)frontend/src/version.ts(auto-generated constant for React components)
- Manual - Button press to start workflow
- Schedule - Cron or interval-based execution
- Webhook - HTTP receiver endpoint
- File Watcher - React to file system changes
- Clipboard - Monitor clipboard changes
- Hotkey - Global keyboard shortcuts
- Startup - Run on app launch
- Telegram - Telegram bot integration
- File Operations - Read, write, append, copy, move, delete, list, get info
- HTTP Request - GET, POST, PUT, DELETE with headers and body
- Shell/Script - Run commands with arguments and working directory
- Desktop Notifications - Windows toast notifications (macOS planned)
- Zip - Compress and extract archives
- Excel - Write to Excel files
- If/Else - Conditional branching
- Switch - Multi-way branching
- Filter - Filter arrays/objects
- Type Check - Validate data types
- isEmpty - Check for empty values
- forEach - Iterate over arrays
- Repeat - Execute N times
- While - Loop with condition
- JSON - Parse and stringify
- Regex - Pattern matching
- Math - Mathematical operations
- CSV - Parse and generate CSV
- Date/Time - Date manipulation
- Variables - Store and retrieve data with {{template}} syntax
- Error Handling - Try/catch with continueOnError
- Ollama - Local LLM integration (auto-detect models)
- OpenAI - GPT models via API
- Groq - Fast inference API
- OpenRouter - Multi-provider AI gateway
- Summarize - AI-powered summaries
- Classify - Categorize content
- Extract - Pull out entities/data
- Rewrite - Transform text
- Generate - Create new content
- Custom Prompt - Your own AI prompts
| Component | Technology |
|---|---|
| Framework | Wails v2 |
| Backend | Go 1.21+ |
| Frontend | React 19 + TypeScript 5.8 |
| Styling | Tailwind CSS v4 |
| Build | Vite 7 |
| Node Editor | @xyflow/react v12 |
| State | Zustand |
| Icons | Lucide React |
ForgeFlow/
├── frontend/ # React frontend
│ ├── src/
│ │ ├── components/
│ │ │ ├── flow/ # Flow editor components
│ │ │ ├── layout/ # Layout components (Header, Sidebar, StatusBar)
│ │ │ └── ui/ # Reusable UI components & specialized fields
│ │ ├── stores/ # Zustand stores (flow, execution, settings, etc.)
│ │ ├── types/ # TypeScript types
│ │ ├── nodes/ # Node definitions
│ │ ├── handlers/ # Node execution handlers
│ │ ├── executor/ # Workflow execution engine
│ │ └── data/templates/ # Workflow templates
│ └── wailsjs/ # Auto-generated Wails bindings
├── build/ # Wails build assets
├── main.go # Wails app entry point
├── app.go # App service (dialogs, utils)
├── engine.go # Automation execution engine
├── storage.go # Flow persistence service
├── actions.go # Platform-specific actions
└── excel.go # Excel file operations
- Core execution engine with node-by-node visual feedback
- Visual node-based automation builder (drag & drop + click-to-add)
- Run/Stop workflow execution with real-time status
- Node status indicators (running/success/error with glow effects)
- Node settings panel (right sidebar configuration)
- Custom frameless titlebar with window controls
- Execution history with detailed node-level results
- Import/Export workflows as JSON (with drag-and-drop)
- Auto-layout algorithm for organizing workflows
- MiniMap with category-based coloring
- Local file persistence
- Specialized input fields (cron, hotkey, file picker)
- Dark mode UI
- HTTP Request action (GET, POST, PUT, DELETE with headers/body)
- Shell/Script execution (run commands with args and working dir)
- File operations (read, write, append, copy, move, delete, list, info)
- Triggers (manual, schedule/cron, webhook, file watcher, clipboard, hotkey, startup, Telegram)
- Data utilities (JSON parse/stringify, regex, math, CSV, date/time)
- Zip compress/extract
- Excel write support
- Desktop notifications (Windows toast notifications)
- Conditional nodes (if/else, switch, filter, type check, isEmpty)
- Loop nodes (forEach, repeat, while)
- Error handling (try/catch node with continueOnError)
- Variables with template syntax ({{variable}})
- Flow templates library
- Ollama integration (local LLM support, auto-detect models)
- OpenAI/Groq/OpenRouter API integration
- Background trigger activation (auto-start on app launch)
- Undo/Redo (Ctrl+Z / Ctrl+Y) with 50-step history
- Copy/Paste nodes (Ctrl+C / Ctrl+V)
- Community Templates (fetch & import from GitHub - submit yours here)
- Custom Node Builder (create your own nodes with shell/HTTP/JavaScript)
- System tray with background running
- SQLite storage (currently using JSON files)
- More AI providers
- Plugin system for custom integrations
MIT License - see LICENSE for details.
Built with ❤️ for privacy-conscious automation enthusiasts.