Welcome

Flux is a Python framework for durable workflow orchestration with first-class AI agents built in. You write normal async Python; Flux handles crashes, retries, scheduling, pauses for human review, and long-running agent loops without losing state.

Who Flux is for

• Engineers building data and ML pipelines that must survive restarts and partial failures.
• AI/ML engineers building agents that run for minutes-to-days, call tools, hold memory, and need human approval at key steps.
• Platform teams running multi-tenant Python workloads with built-in security, observability, and scheduling.

What’s in the box (v0.56.0)

• Workflows and tasks: @workflow and @task decorators that produce durable, restartable execution graphs.
• Agent framework: agent() in flux.tasks.ai, with tools, memory, planning, sub-agents, and tool-approval. Works with Anthropic, OpenAI, Gemini, and Ollama.
• MCP integration: Flux is both an MCP server (workflows as tools) and an MCP client (agents calling MCP tools).
• Scheduling, pause/resume, cancellation, and human-approval primitives (including standing grants) for long-running and human-in-the-loop work.
• Isolated execution: each workflow runs in its own credential-less subprocess by default, with in-process and Docker runners as alternatives.
• Smart dispatch: label affinity and resource matching, plus scoring policies that route work by worker-advertised metrics — and workers that detect their own event-loop starvation and step out of the pool until they recover.
• Production-shaped: multi-tenancy via namespaces, OIDC auth, RBAC, encryption at rest, observability hooks, multi-replica server topology on PostgreSQL, and automatic schema migrations.

Not a fit if

• You need a UI-first workflow tool (no-code drag-and-drop). Flux is code-first.
• You’re orchestrating non-Python services exclusively. Flux’s SDK is Python; other languages are on the roadmap, not shipping today.
• You’re orchestrating short, stateless HTTP calls. Use a queue or a scheduler; Flux’s durability machinery is overhead you won’t need.

Where to next