Skip to content

fluxturn/fluxturn

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

91 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

FluxTurn

FluxTurn

Open-source AI-powered workflow automation platform

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

License GitHub Stars Issues Pull Requests Discord

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 Visual Workflow Builder
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)

Feature FluxTurn Zapier/Make n8n Temporal Custom Scripts
AI Workflow Generation βœ… Built-in ❌ ❌ ❌ ❌
Visual Builder βœ… ReactFlow βœ… βœ… ❌ ❌
Self-Hosted βœ… Free ❌ βœ… βœ… βœ…
Open Source βœ… Apache 2.0 ❌ βœ… Fair-code βœ… MIT N/A
Pre-Built Connectors βœ… 120+ βœ… 5000+ βœ… 400+ ❌ ❌
Real-Time Monitoring βœ… WebSocket βœ… βœ… βœ… ❌
Multi-Language UI βœ… 17 languages βœ… ❌ ❌ N/A
No Per-Execution Cost βœ… ❌ βœ… βœ… βœ…
Production Ready βœ… NestJS βœ… βœ… βœ… ⚠️
Natural Language Input βœ… ❌ ❌ ❌ ❌
Vector Search (Qdrant) βœ… ❌ ❌ ❌ ❌
Learning Curve 🟒 Low 🟒 Low 🟑 Medium πŸ”΄ High πŸ”΄ High

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 -- Apache 2.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

GitHub Stars Forks Contributors Last Commit

Open Issues Open PRs Closed Issues Closed PRs

Community Metrics

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

Language & Code Statistics

Top Language Language Count Repo Size License

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:

Category Connectors
AI & ML OpenAI, OpenAI Chatbot, Anthropic, Google AI, Google Gemini, AWS Bedrock
Analytics Google Analytics, Grafana, Metabase, Mixpanel, PostHog, Segment, Splunk
CMS WordPress, Contentful, Ghost, Medium, Webflow
Communication Slack, Gmail, Microsoft Teams, Telegram, Discord, Twilio, WhatsApp, AWS SES, SMTP, IMAP, POP3, Google Calendar, Calendly, Discourse, Matrix, Mattermost
CRM & Sales HubSpot, Salesforce, Pipedrive, Zoho CRM, Airtable, Monday.com
Data Processing Supabase, Scrapfly, Extract From File
Database Elasticsearch
Development GitHub, GitLab, Bitbucket, Git, Jenkins, Travis CI, Netlify, n8n, npm
E-Commerce Shopify, Stripe, PayPal, WooCommerce, Magento, Paddle, Gumroad
Finance QuickBooks, Plaid, Chargebee, Wise, Xero
Forms Google Forms, Jotform, Typeform
Marketing Mailchimp, Klaviyo, SendGrid, Brevo, ActiveCampaign, Google Ads, Facebook Ads
Productivity Figma, Todoist, Spotify, Clockify, Toggl, Harvest
Project Management Jira, Asana, Trello, Notion, Linear, ClickUp
Social Twitter/X, Facebook, Instagram, TikTok, LinkedIn, Pinterest, Reddit
Storage Google Drive, Google Docs, Google Sheets, Dropbox, AWS S3, PostgreSQL, MySQL, MongoDB, Redis, Snowflake
Support Zendesk, Intercom, Freshdesk, ServiceNow, PagerDuty, Sentry
Utility Bitly, DeepL, FTP, SSH, Execute Command
Video YouTube, Zoom

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

🟑 Intermediate

πŸ”΄ Advanced

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?

Contributing

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

Ways to contribute:

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!

Discord GitHub Discussions Twitter

Where to Find Us

Platform Purpose Link
πŸ’¬ Discord Real-time chat, get help, discuss features Join Server
πŸ’‘ GitHub Discussions Ask questions, share ideas, feature requests Start Discussion
🐦 Twitter/X Product updates, announcements, tips @fluxturn
πŸ“§ Email Direct contact with maintainers [email protected]
🌐 Website Documentation, guides, blog fluxturn.com

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 Apache License 2.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! ⭐

Star on GitHub

Releases

No releases published

Packages

 
 
 

Contributors

Languages