Our take
- Activity
- 51
- Community
- 78
- Issues
- 38
- Pull requests
- 61
+5 stars in the last 30 days
- Slower to close issues than 81% of the projects we track
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
1,932Forks
349Change since Nov 14, 2026: 0 stars·0 forks
Overview
SpiffWorkflow is a pure-Python engine that parses and executes workflows. It addresses the gap between visual process models and application logic: teams can define processes in BPMN diagrams and connect them to Python scripts, or build workflows directly in code.
It is aimed at developers creating workflow-driven applications, especially when business processes need to be represented visually and executed by a Python application. BPMN and DMN support make it more than a general-purpose task queue, but its suitability depends on the standards and process features a project requires.
Key Features
- Parse and execute BPMN workflow diagrams.
- Handle BPMN constructs including pools and lanes, multi-instance tasks, sub-workflows, timer events, signals, messages, boundary events, and looping.
- Provide a baseline DMN implementation integrated with the Python execution engine.
- Build workflows directly in Python or run workflows represented by an internal JSON structure.
- Use Python scripts alongside diagram-defined processes.
- Install as a Python package with
pip install spiffworkflow.
Use Cases
- Python application developers can execute business processes modeled by analysts or other non-developers in BPMN diagrams.
- Teams can embed workflow execution in low-code business applications where process diagrams should drive application behavior.
- Developers can implement and run code-defined workflows when a visual BPMN model is not needed.
- Organizations using decision tables can evaluate whether the baseline DMN support covers their requirements, alongside BPMN execution.
Getting Started
Install the package:
pip install spiffworkflow
See the README and documentation for setup details and examples.
Alternatives
- n8n: n8n is a visual app-integration automation platform, while SpiffWorkflow is a Python engine for executing code-defined or BPMN business processes.
| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| SpiffWorkflow | Python | LGPL-3.0 | 1.9k | Not checked yet |
| n8n | TypeScript | – | 209k | Active |
Considerations
- The README describes DMN support as a baseline implementation, so verify that it meets the needs of your decision-modeling use case.
- The repository documents a broad set of BPMN constructs, but compatibility with a specific model should be checked against the documentation and examples.
- The project is licensed under LGPL-3.0. Review the license in the context of how you plan to distribute or integrate it.
- The README identifies
lxmlas a dependency for XML parsing; development and test workflows also have separate setup instructions.
Found this useful?
Share it with someone who would like SpiffWorkflow.