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
- 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# Build production binary
wails buildThe binary will be in build/bin/.
- File Trigger - React to file changes
- Schedule - Cron or interval-based
- Webhook - HTTP receiver
- Manual - Button press
- System - App/process events
- File Ops - Move, rename, delete files
- HTTP Request - Call external APIs
- Shell Command - Run system commands (sandboxed)
- Notify - Desktop notifications
- 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/ # UI components
│ │ ├── stores/ # Zustand stores
│ │ └── types/ # TypeScript types
├── main.go # App entry point
├── app.go # App utilities
├── engine.go # Execution engine
└── storage.go # Persistence
- 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)
- Custom Node Builder (create your own nodes with shell/HTTP/JavaScript)
- System tray with background running
- Global hotkey listener
MIT License - see LICENSE for details.
Built with ❤️ for privacy-conscious automation enthusiasts.