N8N_Builder: AI-Powered Workflow Automation
July 19, 2025 · View on GitHub
🤖 Transform plain English into powerful N8N workflows using AI
Built with Augment Code - Demonstrating advanced AI-assisted development capabilities
🏷️ Editions
N8N_Builder is available in two editions:
| Edition | Description | Best For |
|---|---|---|
| 🌟 Community Edition | Full AI workflow generation with standard error handling | Individual developers, learning, open source projects |
| 🚀 Private Modules | Optional enhanced monitoring and recovery capabilities | Production environments, enterprise deployments |
Note: This repository contains the complete Community Edition. Optional Private modules are being held in reserve at this time.
🚀 Quick Start (Choose Your Speed)
| Time Available | Start Here | What You'll Get |
|---|---|---|
| 15 minutes | 📖 Getting Started | Complete setup + understanding |
| 30 minutes | 🔗 Integration Guide | Connect external services |
| 45 minutes | 🔧 Troubleshooting | Handle common issues |
🏗️ How It Works
graph LR
A[Describe in English] --> B[AI Generates JSON]
B --> C[Import to n8n]
C --> D[Workflow Runs]
classDef process fill:#e8f5e8
class A,B,C,D process
Complete System:
- 🤖 N8N_Builder (this repo) - AI workflow generator
- 🐳 n8n-docker - Production execution environment
- 🔄 Integration - Seamless workflow transfer
- 🚀 Optional Modules - Enhanced monitoring and recovery (separate deployment)
✨ What You Can Build
💡 Example Automations:
- "Send me an email when a new file is uploaded to my folder"
- "Post to Twitter when I publish a new blog article"
- "Convert CSV files to JSON and send to a webhook"
- "Alert me when my website goes down"
- "Send welcome emails to new customers"
🎯 Key Features
🌟 Community Edition Features
- 🤖 AI-Powered: Convert plain English to n8n workflows
- 🔍 Smart Research: Real-time n8n documentation lookup
- ⚡ Dual APIs: Standard REST + AG-UI Protocol
- ✅ Validation: Ensures workflows meet n8n standards
- 🔄 Iteration: Modify existing workflows easily
- 🌐 Web Interface: User-friendly workflow generation
- 🏭 Production Ready: Complete Docker execution environment
- 🔧 Basic Error Handling: Standard retry logic and error logging
- 🧪 Testing Suite: Core system validation and health checks
🚀 Private Modules
- 📊 Advanced Monitoring: Real-time system health dashboards
- 🛡️ Automated Recovery: Intelligent error detection and resolution
- 🗄️ Enhanced Database: Advanced data management with stored procedures
- 📋 Log Management: 24-hour rotation with compression and retention
- 🧹 Smart Maintenance: Automated project optimization and cleanup
- 🔄 Automated Recovery: Proactive system maintenance and recovery
🚀 Getting Started
🌟 Community Edition (This Repository)
Run the Community Edition:
# Start N8N Builder
python run.py
Basic Health Check:
# Run core system tests
python tests/test_system_health.py
🔍 How to Tell Which Edition You're Running
- Community: Standard error logging, basic retry logic
- Private: Advanced monitoring dashboard, automated recovery system
📚 Documentation
🎯 Start Here
- 🏗️ Architecture Overview - System design and components
- 🔧 Troubleshooting Guide - Fix common issues
- 🎨 Design Principles - Project philosophy and approach
🔧 For Developers
- ⚡ Developer Workflow - Development process and VS Code integration
- 📚 API Reference - Complete API documentation
- 📋 Technical Specifications - Detailed technical specs
🐳 n8n-docker Setup
- 📖 Getting Started Guide - Complete setup instructions
- 🔗 Integration Setup - Connect external services
🤖 Advanced Topics
- 🎨 Design Principles - Project philosophy and architecture
- 📋 Technical Specifications - Detailed system specs
🚀 Recent Updates
🌟 Community Edition (Latest)
- ✅ Enhanced AI Generation - Improved workflow quality and reliability
- ✅ MCP Research Integration - Real-time n8n documentation lookup
- ✅ Better Error Handling - Robust retry logic and fallback strategies
- ✅ Dual API Support - Standard REST + AG-UI Protocol
- ✅ Improved Validation - Enhanced workflow structure checking
- ✅ Docker Integration - Streamlined n8n-docker setup
🚀 Advanced Private Module Features
- ✅ System Health Monitoring - Real-time system health dashboards
- ✅ Automated Recovery - Intelligent error detection and resolution
- ✅ Database Enhancement - Stored procedures for optimal performance
- ✅ Log Management - 24-hour rotation with compression and retention
- ✅ Smart Maintenance - Automated project optimization and cleanup
👨💻 Developer Workflow
Quick Start for Developers:
- Work in N8N_Builder (main workspace)
- Commit + Sync:
Ctrl+Shift+P→ "Tasks: Run Task" → "Commit and Sync Community" - Enter messages: Main commit message + community message (or skip)
- Done! Changes committed locally + synced to GitHub automatically
📖 Complete Developer Guide - Detailed workflow documentation
🤝 Contributing
- Fork the repository
- Create a feature branch
- Add tests for new features
- Update documentation
- Submit a pull request
📄 License
MIT License - See LICENSE file for details
📊 Project Overview
N8N_Builder represents a focused, well-architected solution for AI-powered workflow automation:
🎯 Project Statistics
- 📁 Streamlined Documentation: 11 organized files (reduced from 69)
- 🌟 Community Edition: Full-featured open source version
- 🚀 Private Modules: Optional advanced features available separately
- 🔧 Maintenance Scripts: Automated project management and optimization
📈 Architecture Highlights
| Component | Description | Benefits |
|---|---|---|
| 🤖 AI-Powered Core | Local LLM integration with LM Studio | Privacy-first, no external API calls |
| 🏗️ Clean Architecture | Modular FastAPI-based design | Easy to extend and maintain |
| 📚 Comprehensive Docs | Hierarchical documentation structure | Quick start to detailed specifications |
| 🔧 Script-Driven Ops | Automated maintenance and analysis | Reduces manual effort, improves reliability |
| 🐳 Docker Integration | Seamless n8n-docker deployment | Production-ready containerization |
🏗️ Development Philosophy
- 🎯 Simplicity First: Clean, maintainable code over complexity
- ✅ Documentation-Driven: Every feature thoroughly documented
- 🔄 Script-Driven Operations: Automate repetitive tasks for reliability
- 🛡️ Privacy-Focused: All AI processing happens locally
- 📈 Community-Centered: Open source with MIT License
🌟 Quality Assurance
- 🏛️ Structured Organization: Clear separation of concerns
- 🔗 Validated Links: All documentation cross-references verified
- 🧪 Comprehensive Testing: Robust validation and quality checks
- 📈 Continuous Improvement: Regular optimization and cleanup
Notes:
At the moment the current version should be considered a draft. Having made various changes to the code base, I have not yet run the tests to ensure that everything is still working as expected. I will be doing that soon, and will update the repository accordingly. I am also in the process of writing additional tests to ensure that all of the new features are properly tested. I will be updating the documentation as I go, and will be adding additional documentation as needed. I will also be adding additional comments to the code as needed. My experience with it at the moment is a bit spotty, probably due to my determination to use local models. That said, it does work, but not always. I believe the concept and the architecture are sound, but more tooling around is needed.
This was built using Cursor for the first pass, but it fell down completely after that, so I switched to Augment, which is much more stable once the first pass has been completed. I could have used Augment for both, as they both would use Claude 4, but I had existing credits to use on Cursor... and if it hadn't crapped out on me with ridiculous mistakes and code crushing errors, I would have simply stuck with it. Augment is far more stable on existing code bases in my experience. I started working on this on June 20th, so that may give you an idea of how effective Augment is. On the other hand I ran out of credits for it several times since then, and so I paid about $40 in extra credits. Not too bad given how much I learned in the process, and how happy I am with the results overall.
While not required by the MIT license, if you find this code useful in your projects, a link back to this repository would be appreciated. And, of course, we should give credit where credit is due - to Augment Code and Anthropic's Claude 4, of course. Well, and to me for having the many years worth of experience in software development to use them well enough to ensure that the results are useful and of high quality. Thank you!
🎉 Ready to automate your workflows with AI? Start with 📖 Getting Started and be running in 15 minutes!