Installation¶

Requirements¶

TriageSim requires Python 3.11 or newer. It is tested against 3.11, 3.12 and 3.13.

Running a simulation also requires an OpenRouter API key, since both agents call a hosted model. See Configuration.

pip install triagesim

This installs the core framework and its four runtime dependencies: pydantic, pydantic-ai[openrouter], python-dotenv, and PyYAML.

Redis state storeAudio renderingDevelopment

Persist run state to Redis instead of process memory, so runs survive the Python process and can be inspected or replayed later.

pip install "triagesim[redis]"

Requires a reachable Redis server. See Redis-backed runs.

Synthesise multi-speaker speech from a finished dialogue using XTTS-v2.

pip install "triagesim[audio]"

This pulls in torch and TTS, which are large. Install it only if you need speech output. See Audio rendering.

Test dependencies, plus the redis extra.

pip install "triagesim[dev]"

Extras compose, so you can combine them:

pip install "triagesim[redis,audio]"

To track the latest unreleased changes:

pip install "git+https://github.com/dipankarsrirag/triage-sim.git"

Or clone and install in editable mode to modify the framework itself:

git clone https://github.com/dipankarsrirag/triage-sim.git
cd triage-sim
pip install -e ".[dev]"
pytest

import triagesim

print(triagesim.__version__)

The package ships a py.typed marker, so type checkers such as mypy and pyright will resolve its annotations without stubs.