Installation

Requirements

• Python >=3.10
• uv for dependency and environment management

Install the Package

uv add stateless-py

If you are developing from source:

git clone https://github.com/alti3/stateless-py.git
cd stateless-py
uv sync

Development Dependencies

uv sync --all-extras

Common Dev Commands

uvx pytest
uvx ruff check .
uvx ruff format .
uvx ty check

Optional Graph Rendering

To render diagrams with Graphviz through StateMachine.visualize(...), install the graphing extra:

uv add "stateless-py[graphing]"

You also need the Graphviz dot executable available on your system PATH.