kmmbvnr/django-fsm

Health v2 · maintenance only

Adoption not part of the score

2352 stars · 298 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A Python library providing Django-friendly finite state machine support, allowing declarative definition of states and guarded transitions on model fields. It has been renamed and superseded by viewflow.fsm as of version 3.0, which has a new, incompatible API.

Use cases

• add a state machine to a django model
• enforce allowed state transitions in a workflow
• implement order status lifecycle in django
• prevent invalid state assignment on model fields
• model approval or publishing workflows in python

When to choose

• you need declarative FSM transitions on Django models
• you want transition guards and TransitionNotAllowed enforcement
• you are maintaining a legacy project already using django-fsm

When to avoid

• you are starting a new project - use viewflow.fsm instead
• you need a framework-agnostic state machine without Django
• you need a full workflow/BPM engine rather than a simple FSM

Facets

library · maturity maintenance

state-management workflow-automation web-development backend developer-tools python django finite-state-machine fsm state-machine transitions viewflow

Member repositories

For agents

markdown · JSON · MCP: product_card(name="kmmbvnr/django-fsm")