knipknap

SpiffWorkflow: Execute Python and BPMN Workflows

SpiffWorkflow is a Python workflow engine for building and running processes defined in code or BPMN diagrams. It suits teams that need executable business workflows, with support for BPMN and a baseline DMN implementation.

View on GitHub Compare
Stars
1.9k
Forks
346
Stars, last 30 days
+5

Our take

Health score

57/100

How it is scored
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.

Selected snapshot

Stars

1,932

Forks

349

Change 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.
ProjectLanguageLicenseStarsStatus
SpiffWorkflowPythonLGPL-3.01.9kNot checked yet
n8nTypeScript–209kActive

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 lxml as 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.

Comparisons