FluxTurn

Open-source AI-powered workflow automation platform

Build, automate, and orchestrate workflows with natural language and a visual builder.

Documentation | Quick Start | Discord | Contributing

English | 日本語 | 中文 | 한국어 | Español | Français | Deutsch | Português | Русский | हिन्दी

What is FluxTurn?

FluxTurn is a production-ready, open-source workflow automation platform that bridges the gap between idea and execution. Built for developers, DevOps teams, and technical users, FluxTurn combines the power of AI-driven workflow generation with a sophisticated visual builder to help you automate complex processes in seconds instead of hours.

Unlike traditional automation tools that require extensive configuration or low-code platforms that sacrifice flexibility, FluxTurn gives you the best of both worlds: the speed of natural language workflow generation and the precision of a visual node-based editor.

FluxTurn's visual workflow builder showing an AI agent workflow with chat memory

How It Works

1. Describe Your Workflow -- Tell FluxTurn what you want to automate in plain English
2. AI Generates the Flow -- Our AI agent analyzes your requirements and creates a complete workflow with the right connectors
3. Visual Refinement -- Fine-tune the generated workflow using our ReactFlow-powered canvas
4. Deploy & Monitor -- Execute workflows in real-time with detailed logging and WebSocket-based monitoring

Key Capabilities

• 🤖 AI Workflow Generation -- Describe what you want in plain English, get a working workflow with proper error handling and best practices
• 🎨 Visual Workflow Builder -- Drag-and-drop interface powered by ReactFlow with real-time validation
• 🔌 120+ Pre-Built Connectors -- Slack, Gmail, Shopify, HubSpot, Jira, Stripe, OpenAI, Anthropic, and many more
• ⚡ Real-Time Execution -- Watch workflows run with detailed logs, WebSocket updates, and performance metrics
• 🏠 Self-Hosted & Privacy-First -- Run on your own infrastructure with Docker, full data control
• 🌍 Multi-Language Support -- 17 languages including English, Japanese, Chinese, Korean, Spanish, and more
• 🔄 Production-Ready -- Built with NestJS, PostgreSQL, Redis, and Qdrant for enterprise-scale deployments

What Problem We Solve

The Automation Dilemma

Modern teams face a critical challenge: automation is essential but time-consuming. Building integrations between tools, handling errors, and maintaining workflows requires significant engineering resources.

Common pain points we address:

• ❌ Manual Integration Hell -- Writing custom scripts to connect different APIs takes hours or days
• ❌ Expensive SaaS Lock-In -- Commercial automation tools charge per workflow execution or user seat
• ❌ Limited Flexibility -- Low-code platforms are easy to start but hard to customize for complex use cases
• ❌ Vendor Dependency -- Cloud-only solutions mean you don't own your automation logic or data
• ❌ Steep Learning Curve -- Traditional workflow engines require deep technical knowledge to set up

FluxTurn's Solution

✅ AI-Powered Speed -- Turn ideas into working workflows in seconds, not hours ✅ Open Source Freedom -- No vendor lock-in, no per-execution fees, full control over your code ✅ Self-Hosted Privacy -- Keep sensitive data and workflows on your infrastructure ✅ Developer-Friendly -- Full API access, extensible connector system, TypeScript codebase ✅ Visual + Code -- Start with AI generation, refine visually, export as code if needed

Why FluxTurn? (Comparison)

What Makes FluxTurn Unique?

1. AI-First Design -- Only workflow platform with native AI workflow generation and natural language understanding
2. Modern Tech Stack -- React 19, NestJS, PostgreSQL, Redis, Qdrant -- built for 2025 and beyond
3. Developer Experience -- Clean TypeScript codebase, extensible architecture, comprehensive API
4. True Open Source -- AGPL-3.0 license, no "fair-code" restrictions, community-driven development
5. Multi-Modal Input -- Natural language OR visual builder OR API -- choose what works for your team

📊 Project Activity & Statistics

FluxTurn is an actively maintained project with a growing community. Here's what's happening:

GitHub Activity

Community Metrics

Metric	Status	Details
Total Contributors		Growing community of developers
Total Commits		Continuous development
Monthly Commits		Active maintenance
Average PR Review Time	~24-48 hours	Fast feedback loop
Code Quality		TypeScript, ESLint, Prettier
Test Coverage		Well-tested codebase
Documentation		Extensive guides & API docs

Language & Code Statistics

Recent Activity Highlights

• ✅ 120+ Connectors shipped and tested
• ✅ 17 Languages supported in the UI
• ✅ 1000+ Commits and counting
• ✅ Active Discord community with real-time support
• ✅ Weekly Releases with new features and bug fixes
• ✅ Responsive Maintainers -- PRs reviewed within 1-2 days

Why These Numbers Matter

Fast PR Reviews -- We value your time. Most pull requests get initial feedback within 24-48 hours, not weeks.

Active Development -- Regular commits mean the project is evolving. New features, bug fixes, and improvements ship continuously.

Growing Contributors -- More contributors = more perspectives, better code quality, and faster feature development.

High Test Coverage -- 85%+ coverage means you can contribute confidently knowing tests will catch regressions.

Comprehensive Docs -- Detailed documentation means less time struggling, more time building.

Join the Activity!

Want to see your contributions here? Check out our Quick Contribution Guide below!

Quick Start

Docker (Recommended)

Run these commands from the project root:

git clone https://github.com/fluxturn/fluxturn.git
cd fluxturn
cp backend/.env.example backend/.env
# Edit backend/.env with your database credentials and JWT secret
docker compose up -d

That's it! Access the app at http://localhost:5185 and the API at http://localhost:5005.

Manual Setup

Prerequisites: Node.js 18+, PostgreSQL 14+, Redis 7+

# Clone
git clone https://github.com/fluxturn/fluxturn.git
cd fluxturn

# Backend
cd backend
cp .env.example .env    # Edit .env with your configuration
npm install
npm run start:dev

# Frontend (in a new terminal)
cd frontend
cp .env.example .env
npm install
npm run dev

Architecture

                    +------------------+
                    |    Frontend      |  React 19 + Vite + Tailwind
                    |  (Port 5185)     |  Visual Workflow Builder
                    +--------+---------+  AI Chat Interface
                             |
                             v
                    +------------------+
                    |    Backend       |  NestJS + TypeScript
                    |  (Port 5005)     |  REST API + WebSocket
                    +--------+---------+  Workflow Engine
                             |
              +--------------+--------------+
              |              |              |
              v              v              v
        +-----------+  +---------+  +----------+
        | PostgreSQL |  |  Redis  |  |  Qdrant  |
        | (Database) |  | (Cache) |  | (Vector) |
        +-----------+  +---------+  +----------+

Frontend (/frontend) -- React 19, Vite, TailwindCSS, ReactFlow, i18next, CodeMirror

Backend (/backend) -- NestJS, PostgreSQL (raw SQL), Redis, Socket.IO, LangChain, 120+ connectors

Connectors

FluxTurn ships with 120+ connectors across these categories:

View all connectors →

i18n

FluxTurn supports 17 languages via i18next:

• English, Japanese, Chinese, Korean, Spanish, French, German, Italian, Russian, Portuguese (BR), Dutch, Polish, Ukrainian, Vietnamese, Indonesian, Arabic, Hindi

Want to add a new language? See the translation guide.

🚀 Why Contribute to FluxTurn?

FluxTurn is more than just another open-source project -- it's an opportunity to work with cutting-edge technology while building something that solves real problems for developers worldwide.

What You'll Gain

📚 Learn Modern Tech Stack

• React 19 -- Latest React features including Server Components
• NestJS -- Professional backend framework used by enterprises
• LangChain -- AI/ML integration and agent orchestration
• Vector Databases -- Work with Qdrant for semantic search
• ReactFlow -- Build interactive node-based UIs
• Real-time Systems -- WebSocket, Redis, and event-driven architecture

💼 Build Your Portfolio

• Contribute to a production-ready platform used by real companies
• Work on features that appear on your GitHub profile
• Get recognition in our contributor hall of fame
• Build expertise in workflow automation and AI integration -- highly valued skills in 2026

🤝 Join a Growing Community

• Connect with developers from around the world
• Get code reviews from experienced maintainers
• Learn best practices in software architecture
• Participate in technical discussions and design decisions

🎯 Make Real Impact

• Your code will help thousands of developers automate their workflows
• See your features being used in production environments
• Influence the direction of an AI-powered automation platform

⚡ Quick Onboarding

• Docker-based setup gets you running in under 5 minutes
• Well-documented codebase with clear architecture
• Friendly maintainers who respond to PRs within 24-48 hours
• "Good first issue" labels for newcomers

🗺️ Project Roadmap

Here's what we're building and where you can contribute. Items marked with 🆘 need help!

Q2 2026 (Current Quarter)

🤖 AI & Intelligence

• [ ] 🆘 AI Workflow Optimization -- Auto-suggest performance improvements for workflows
• [ ] Multi-Agent Workflows -- Support for parallel AI agents with coordination
• [ ] 🆘 Natural Language Workflow Editing -- "Add error handling to step 3" updates the workflow
• [ ] Smart Connector Suggestions -- AI recommends connectors based on workflow context

🔌 Connectors & Integrations

• [ ] 🆘 50+ New Connectors -- Notion, Linear, Airtable, Make.com, etc.
• [ ] Connector Marketplace -- Community-contributed connectors
• [ ] 🆘 GraphQL Support -- Add GraphQL connector for modern APIs
• [ ] Database Connectors -- Supabase, PlanetScale, Neon enhancements

🎨 Visual Builder Enhancements

• [ ] 🆘 Workflow Templates -- Pre-built templates for common use cases
• [ ] Conditional Branching UI -- Visual if/else flow builder
• [ ] 🆘 Workflow Versioning -- Track and rollback workflow changes
• [ ] Collaborative Editing -- Multiple users editing the same workflow

Q3 2026

⚡ Performance & Scale

• [ ] Distributed Execution -- Run workflows across multiple workers
• [ ] 🆘 Workflow Caching -- Cache expensive operations
• [ ] Rate Limiting Per Connector -- Automatic backoff and retry
• [ ] Horizontal Scaling -- Multi-instance support with Redis pub/sub

🔐 Enterprise Features

• [ ] RBAC (Role-Based Access Control) -- User permissions and teams
• [ ] 🆘 Audit Logs -- Track all workflow changes and executions
• [ ] SSO Integration -- SAML, OAuth2, LDAP support
• [ ] Secrets Management -- HashiCorp Vault integration

📊 Monitoring & Observability

• [ ] 🆘 Metrics Dashboard -- Execution time, success rate, error tracking
• [ ] OpenTelemetry Integration -- Export traces to Jaeger, Datadog, etc.
• [ ] Alerting System -- Notify on workflow failures
• [ ] 🆘 Workflow Analytics -- Usage patterns and optimization recommendations

Q4 2026 & Beyond

🌐 Platform Expansion

• [ ] CLI Tool -- Manage workflows from terminal
• [ ] 🆘 Workflow as Code -- Define workflows in YAML/JSON
• [ ] CI/CD Integration -- GitHub Actions, GitLab CI connectors

🧩 Developer Experience

• [ ] 🆘 Plugin System -- Custom nodes and connectors via plugins
• [ ] Workflow Testing Framework -- Unit tests for workflows
• [ ] Local Development Mode -- Offline workflow development
• [ ] API Schema Validation -- Auto-validate connector responses

How to Influence the Roadmap

💡 Have ideas? Open a GitHub Discussion or join our Discord

🗳️ Vote on features -- Star issues you care about to help us prioritize

🛠️ Want to build something not listed? -- Propose it! We love community-driven features

🎯 Quick Contribution Guide

Get started contributing in under 10 minutes:

Step 1: Set Up Your Environment

# Fork the repository on GitHub, then clone your fork
git clone https://github.com/YOUR_USERNAME/fluxturn.git
cd fluxturn

# Start with Docker (easiest way)
cp backend/.env.example backend/.env
docker compose up -d

# Access the app
# Frontend: http://localhost:5185
# Backend API: http://localhost:5005

That's it! You're running FluxTurn locally.

Step 2: Find Something to Work On

Choose based on your experience level:

🟢 Beginner-Friendly

• 📝 Fix typos or improve documentation
• 🌍 Add translations -- We support 17 languages
• 🐛 Fix simple bugs
• ✨ Improve UI/UX

🟡 Intermediate

• 🔌 Add a new connector -- See our Connector Development Guide
• 🎨 Enhance the visual builder
• 🧪 Write tests
• 🚀 Performance improvements

🔴 Advanced

• 🤖 AI/ML features
• ⚙️ Core engine enhancements
• 🏗️ Architecture improvements
• 🔐 Security features

Step 3: Make Your Changes

# Create a new branch
git checkout -b feature/your-feature-name

# Make your changes
# - Frontend code: /frontend/src
# - Backend code: /backend/src
# - Connectors: /backend/src/modules/fluxturn/connectors

# Test your changes
npm run test

# Commit with a clear message
git commit -m "feat: add new connector for Notion API"

Step 4: Submit Your Pull Request

# Push to your fork
git push origin feature/your-feature-name

# Open a PR on GitHub
# - Describe what you changed and why
# - Link to any related issues
# - Add screenshots if it's a UI change

What happens next?

• ✅ Automated tests run on your PR
• 👀 A maintainer reviews your code (usually within 24-48 hours)
• 💬 We may suggest changes or improvements
• 🎉 Once approved, your code gets merged!

Contribution Tips

✨ Start small -- Your first PR doesn't need to be a huge feature 📖 Read the code -- Browse existing connectors or components for examples ❓ Ask questions -- Join our Discord if you're stuck 🧪 Write tests -- PRs with tests get merged faster 📝 Document your code -- Add comments for complex logic

Need Help?

• 💬 Discord -- Chat with maintainers and contributors
• 📖 Contributing Guide -- Detailed contribution guidelines
• 🐛 GitHub Issues -- Report bugs or request features
• 💡 Discussions -- Ask questions, share ideas

Contributing

We welcome contributions! See our Contributing Guide to get started.

Ways to contribute:

• Report bugs or request features via GitHub Issues
• Submit pull requests for bug fixes or new features
• Add new connectors (see the Connector Development Guide)
• Improve documentation
• Add translations

Contributors

Thank you to all the amazing people who have contributed to FluxTurn! 🎉

Want to see your face here? Check out our Contributing Guide and start contributing today!

💬 Join Our Community

Connect with developers, get help, and stay updated on FluxTurn's latest developments!

Where to Find Us

Community Guidelines

• 🤝 Be Respectful -- Treat everyone with respect and kindness
• 💡 Share Knowledge -- Help others learn and grow
• 🐛 Report Issues -- Found a bug? Let us know on GitHub Issues
• 🎉 Celebrate Wins -- Share your workflows and success stories
• 🌍 Think Global -- We're a worldwide community with 17+ languages

License

This project is licensed under the GNU Affero General Public License v3.0.

Acknowledgments

Built with NestJS, React, ReactFlow, TypeScript, and i18next.

Website | Docs | Discord | Twitter

Built with ❤️ by the fluxturn community

If you find this project useful, please consider giving it a star! ⭐