Installation

Requirements

• Python 3.12+
• uv package manager (recommended) or pip

Install from PyPI

# With uv (recommended)
uv add orchestrix

# With pip
pip install orchestrix

Optional Extras

# PostgreSQL event store
pip install orchestrix[postgres]

# Observability (Prometheus + OpenTelemetry)
pip install orchestrix[observability]

# All extras
pip install orchestrix[postgres,observability]

Install from Source

git clone https://github.com/stefanposs/orchestrix.git
cd orchestrix
uv sync --all-extras --dev

Verify

from orchestrix.core.messaging.message import Command, Event
from orchestrix.infrastructure.memory.store import InMemoryEventStore

print("Orchestrix ready!")

Next Steps

• Quick Start — Build your first event-sourced app
• Core Concepts — Commands, Events, Aggregates