{"adoption": {"forks": 109, "observed_at": "2026-08-28T04:04:17.267183+00:00", "stars": 1298}, "canonical_url": "https://ross.abutalabs.com/products/python-statemachine", "card": {"archived": false, "artifact_type": "library", "description": "Expressive statecharts and FSMs for modern Python.", "domain": ["developer-tools"], "enriched": true, "function": ["state-management", "developer-tools"], "health_score": 99, "homepage": "https://python-statemachine.readthedocs.io", "language": "Python", "license": "MIT", "license_family": "permissive", "maturity": "active", "member_repos": ["fgmacedo/python-statemachine"], "name": "fgmacedo/python-statemachine", "platform": ["python", "cross-platform"], "pushed_at": "2026-08-17T21:38:31+00:00", "repo": "fgmacedo/python-statemachine", "stars": 1298, "tags": ["state-machine", "statechart", "fsm", "harel-statechart", "scxml", "hierarchical-state-machine", "async-support", "diagram-generation", "automation", "algorithms"], "topics": ["state-machine", "statemachine", "automata", "finite-state-machine", "python", "fsm", "fsm-library", "state", "state-machine-diagram", "state-machine-dsl", "state-management", "scxml", "statechart", "statecharts", "hierarchical-state-machine", "hsm", "harel-statechart"], "urls": [], "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"], "what_it_is": "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.", "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"], "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"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/python-statemachine", "repo": "fgmacedo/python-statemachine", "role": "main", "score": 93}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:04:17.267183+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-30T04:53:49.972435+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "69823f506a7ad10f75e80161499a1d6ffb1b0ee09cd331bdf8e0298140477966", "fetched_at": "2026-08-28T04:04:17.267183+00:00", "kind": "readme", "missing": false, "url": "https://github.com/fgmacedo/python-statemachine"}, {"content_hash": "3a82f563005d4bff1b5d632a0f7e50e715a1be278325b3d193059be616c64c7a", "fetched_at": "2026-08-29T12:10:40.942274+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/python-statemachine/json"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:04:17.267183+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-30T04:53:49.972435+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "69823f506a7ad10f75e80161499a1d6ffb1b0ee09cd331bdf8e0298140477966", "fetched_at": "2026-08-28T04:04:17.267183+00:00", "kind": "readme", "missing": false, "url": "https://github.com/fgmacedo/python-statemachine"}, {"content_hash": "3a82f563005d4bff1b5d632a0f7e50e715a1be278325b3d193059be616c64c7a", "fetched_at": "2026-08-29T12:10:40.942274+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/python-statemachine/json"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-30T04:53:49.972435+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "69823f506a7ad10f75e80161499a1d6ffb1b0ee09cd331bdf8e0298140477966", "fetched_at": "2026-08-28T04:04:17.267183+00:00", "kind": "readme", "missing": false, "url": "https://github.com/fgmacedo/python-statemachine"}, {"content_hash": "3a82f563005d4bff1b5d632a0f7e50e715a1be278325b3d193059be616c64c7a", "fetched_at": "2026-08-29T12:10:40.942274+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/python-statemachine/json"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:04:17.267183+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:04:17.267183+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:04:17.267183+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-30T04:53:49.972435+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "69823f506a7ad10f75e80161499a1d6ffb1b0ee09cd331bdf8e0298140477966", "fetched_at": "2026-08-28T04:04:17.267183+00:00", "kind": "readme", "missing": false, "url": "https://github.com/fgmacedo/python-statemachine"}, {"content_hash": "3a82f563005d4bff1b5d632a0f7e50e715a1be278325b3d193059be616c64c7a", "fetched_at": "2026-08-29T12:10:40.942274+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/python-statemachine/json"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:04:17.267183+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:04:17.267183+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-30T04:53:49.972435+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "69823f506a7ad10f75e80161499a1d6ffb1b0ee09cd331bdf8e0298140477966", "fetched_at": "2026-08-28T04:04:17.267183+00:00", "kind": "readme", "missing": false, "url": "https://github.com/fgmacedo/python-statemachine"}, {"content_hash": "3a82f563005d4bff1b5d632a0f7e50e715a1be278325b3d193059be616c64c7a", "fetched_at": "2026-08-29T12:10:40.942274+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/python-statemachine/json"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:04:17.267183+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:04:17.267183+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:04:17.267183+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-30T04:53:49.972435+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "69823f506a7ad10f75e80161499a1d6ffb1b0ee09cd331bdf8e0298140477966", "fetched_at": "2026-08-28T04:04:17.267183+00:00", "kind": "readme", "missing": false, "url": "https://github.com/fgmacedo/python-statemachine"}, {"content_hash": "3a82f563005d4bff1b5d632a0f7e50e715a1be278325b3d193059be616c64c7a", "fetched_at": "2026-08-29T12:10:40.942274+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/python-statemachine/json"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:04:17.267183+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:04:17.267183+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-30T04:53:49.972435+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "69823f506a7ad10f75e80161499a1d6ffb1b0ee09cd331bdf8e0298140477966", "fetched_at": "2026-08-28T04:04:17.267183+00:00", "kind": "readme", "missing": false, "url": "https://github.com/fgmacedo/python-statemachine"}, {"content_hash": "3a82f563005d4bff1b5d632a0f7e50e715a1be278325b3d193059be616c64c7a", "fetched_at": "2026-08-29T12:10:40.942274+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/python-statemachine/json"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-30T04:53:49.972435+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "69823f506a7ad10f75e80161499a1d6ffb1b0ee09cd331bdf8e0298140477966", "fetched_at": "2026-08-28T04:04:17.267183+00:00", "kind": "readme", "missing": false, "url": "https://github.com/fgmacedo/python-statemachine"}, {"content_hash": "3a82f563005d4bff1b5d632a0f7e50e715a1be278325b3d193059be616c64c7a", "fetched_at": "2026-08-29T12:10:40.942274+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/python-statemachine/json"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-30T04:53:49.972435+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "69823f506a7ad10f75e80161499a1d6ffb1b0ee09cd331bdf8e0298140477966", "fetched_at": "2026-08-28T04:04:17.267183+00:00", "kind": "readme", "missing": false, "url": "https://github.com/fgmacedo/python-statemachine"}, {"content_hash": "3a82f563005d4bff1b5d632a0f7e50e715a1be278325b3d193059be616c64c7a", "fetched_at": "2026-08-29T12:10:40.942274+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/python-statemachine/json"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-30T04:53:49.972435+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "69823f506a7ad10f75e80161499a1d6ffb1b0ee09cd331bdf8e0298140477966", "fetched_at": "2026-08-28T04:04:17.267183+00:00", "kind": "readme", "missing": false, "url": "https://github.com/fgmacedo/python-statemachine"}, {"content_hash": "3a82f563005d4bff1b5d632a0f7e50e715a1be278325b3d193059be616c64c7a", "fetched_at": "2026-08-29T12:10:40.942274+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/python-statemachine/json"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 98, "longevity": 100, "rhythm": 83}, "computed_at": "2026-09-03T02:20:16.233290+00:00", "flags": [], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 3451, "days_push": 16, "days_rel": 32, "gap_med": 37.0, "n_releases_24m": 9}, "score": 93, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}