Starsim Starsim STIsim

Agent-based STI + HIV modeling · Built on Starsim

STIsim

STIsim is an agent-based modeling framework for simulating co-circulating sexually transmitted infections. Built on the Starsim architecture, it supports structured sexual networks, multiple co-transmitting infections (HIV, syphilis, chlamydia, gonorrhea, trichomoniasis, bacterial vaginosis, and others), risk-stratified populations, and a flexible intervention library spanning screening, testing, treatment, and prevention. It is implemented in pure Python, extensively tested and documented, and runs in seconds to minutes on a laptop.

Installation pip install stisim

Just want HIVsim? It's included in the STIsim package, so there's nothing extra to install. Use it with import hivsim.

New to Python? Install STIsim + Jupyter
Windows
Mac
  1. Open Terminal (press ⌘-Space, type Terminal, press Enter).
  2. Paste this and press Enter:
    curl -LsSf https://stisim.org/install.sh | sh

On Windows, double-click the downloaded file. If Windows warns about it, click More info → Run anyway.

Editable copy from GitHub git clone https://github.com/starsimhub/stisim.git
cd stisim
pip install -e .

Use pip install -e .[dev] to include test and docs dependencies.