emodpy-hiv
The Python interface for running EMOD HIV simulations.
Description
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.
Project status
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.
Try it now
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.
Installation
pip install emodpy-hiv
For 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.
Documentation
Full documentation: https://emod.idmod.org/emodpy-hiv
Releases and changelog: https://github.com/EMOD-Hub/emodpy-hiv/releases
Community
Have a question or a comment? Check out our Discussions space.
Contributing
If you have feature requests, issues, or new code, please see our CONTRIBUTING page for how to provide your feedback.
Metadata
Release files for emodpy-hiv 3.3.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| emodpy_hiv-3.3.2.tar.gz | 417.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| emodpy_hiv-3.3.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 858.3 kB
Release files / emodpy_hiv-3.3.2.tar.gz
| Download URL | emodpy_hiv-3.3.2.tar.gz |
|---|---|
| Size | 417.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e05ce9e2e5e05e57ba1b9d21783bb25a4fc050c0a141b189e59cae8dbc953f8b
|
|
BLAKE2b-256 checksum How to use checksums |
417f01778b37c77f30c5bff8cd454c31508769efb2e18b7ca9905c01d63b8ba8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 12, 2026.
Transparency logRelease files / emodpy_hiv-3.3.2-py3-none-any.whl
| Download URL | emodpy_hiv-3.3.2-py3-none-any.whl |
|---|---|
| Size | 440.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5f72c71385c65006c7284506532e3a468003dcad295a91f2f1683d89dea40748
|
|
BLAKE2b-256 checksum How to use checksums |
4a7432dec533b984039342a4585147d16b8163edba2178aa0323655d309b6bec
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 12, 2026.
Transparency log