pytransitions/transitions

Health v2 · maintenance only

Adoption not part of the score

6582 stars · 568 forks observed · 2026-08-28

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

A lightweight, object-oriented finite state machine library for Python with extensions for nested/hierarchical states, conditions, callbacks, and diagram generation. It is installable via pip and compatible with Python 2.7+ and 3.0+.

Use cases

• implement a finite state machine in python
• model object states with transitions and callbacks
• create hierarchical or nested state machines
• add conditional transitions to python objects
• generate state diagrams from machine definitions
• manage workflow states in a python application

When to choose

• you need a lightweight, pure-Python state machine with no heavy dependencies
• you want features like nested states, ordered/queued transitions, and conditions
• you want to attach state machine behavior directly to your own classes

When to avoid

• you need a distributed or persistent workflow engine rather than an in-process FSM
• your project is not in Python

Facets

library · maturity stable

state-management developer-tools developer-tools python cross-platform finite-state-machine state-machine hierarchical-states nested-states state-diagram object-oriented algorithms automation

Member repositories

For agents

markdown · JSON · MCP: product_card(name="pytransitions/transitions")