fgmacedo/python-statemachine

Health v2 · maintenance only

Adoption not part of the score

1298 stars · 109 forks observed · 2026-08-28

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

A Python library for defining finite state machines and full Harel statecharts with a declarative, pythonic API. It supports compound states, parallel regions, history, sync/async code, and diagram generation.

Use cases

• model business logic as a state machine in Python
• implement statecharts with hierarchical and parallel states
• add finite state machine behavior to a Python class
• generate state machine diagrams from code
• manage async state transitions in Python applications

When to choose

• you need expressive statecharts (compound, parallel, history states) in Python
• you want a clean declarative DSL with hooks like on_enter/on_exit and guards
• you need both sync and async support
• you want automatic diagram or markdown documentation of transitions

When to avoid

• you need a distributed or persistent workflow engine rather than in-process state logic
• your project is not Python
• you only need simple boolean flags instead of formal state modeling

Facets

library · maturity active

state-management developer-tools developer-tools python cross-platform state-machine statechart fsm harel-statechart scxml hierarchical-state-machine async-support diagram-generation automation algorithms

Member repositories

For agents

markdown · JSON · MCP: product_card(name="fgmacedo/python-statemachine")