The Python interface for running EMOD HIV simulations.
emodpy-hiv is the primary way to work with EMOD for HIV research. Use it to set up transmission settings, define populations, and evaluate the impact of interventions such as antiretroviral therapy, voluntary medical male circumcision, prevention of mother-to-child transmission, and PrEP — then run simulations and analyze the results.
EMOD-Hub projects are provided as open source software under the MIT License for community use, research, and development.
Unless otherwise noted, these projects are no longer actively maintained or supported by IDM or the Gates Foundation.
Community contributions are welcome, and trusted collaborators may review and merge pull requests, but no guarantees are made regarding support, pull request review, security response, maintenance, or release timelines.
No installation required. Open the repository in GitHub Codespaces, wait for the environment to build, then run:
cd tutorials
python tutorial_1_intro.py
See the tutorial setup page for Codespaces and local installation instructions, and Tutorial 1 for a walkthrough of what the script does.
pip install emodpy-hivFor complete installation instructions, including Codespaces, container-based workflows, and local environment setup, see:
https://emod.idmod.org/emodpy-hiv/installation/
For developers, see the developer installation instructions.
Full documentation: https://emod.idmod.org/emodpy-hiv
Releases and changelog: https://github.com/EMOD-Hub/emodpy-hiv/releases
Have a question or a comment? Check out our Discussions space.
If you have feature requests, issues, or new code, please see our CONTRIBUTING page for how to provide your feedback.