Epigrass
If you use epigrass in your research, please use the following DOI to cite it:
@software{flavio_codeco_coelho_2021_4554753,
author = {Flávio Codeço Coelho},
title = {fccoelho/epigrass: COVID19},
month = feb,
year = 2021,
publisher = {Zenodo},
version = {v3.0.2},
doi = {10.5281/zenodo.4554753},
url = {https://doi.org/10.5281/zenodo.4554753}
}
Epidemiological Geo-referenced Analysis and Simulation system
Epigrass is a Python Library aimed at making the simulation of metapopulation models as easy as possible.
Documentation is available here.
Installation
External dependencies
Besides installing epigrass from the PyPI, as described below you will need to install the following external dependencies:
- redis server you need to have a redis server running. You can install it from the redis website
You can install Epigrass directly from PyPI, the Python Package Index. For mode details, check the docs
Installing from the repository
If you clone the repository, you can install Epigrass with the following command:
$ uv sync
Running the Gradio Simulation Builder
Epigrass now includes a modern web-based simulation builder built with Gradio. This interface allows you to create, edit, and run simulations easily.
To launch the simulation builder:
$ uv run epigrass
This will start a local web server and provide a URL (usually http://127.0.0.1:7860) where you can access the interface.
Running demos
The source distribution comes with a few demos.
$ cd demos
$ uv run epirunner rio.epg
This will run the demo for the city of Rio de Janeiro.
Getting started building your own models
Folow these instructions.
Metadata
Release files for epigrass 4.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| epigrass-4.1.1.tar.gz | 5.2 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| epigrass-4.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 5.3 MB
Release files / epigrass-4.1.1.tar.gz
| Download URL | epigrass-4.1.1.tar.gz |
|---|---|
| Size | 5.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e681a5b217c9c12b192906ae70f7e15cc4b0ddb0ca3825cea1c832f02545e19d
|
|
BLAKE2b-256 checksum How to use checksums |
be65b8c40d1f1b7f0a7e6255db52f3103018c94ca804df16ecc8bb95a07938fe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Jan 2, 2026.
Transparency logRelease files / epigrass-4.1.1-py3-none-any.whl
| Download URL | epigrass-4.1.1-py3-none-any.whl |
|---|---|
| Size | 112.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
74e6b113a54ac6cb4e4543dfa13529e367f17e8105fb610d115401f16e3a7259
|
|
BLAKE2b-256 checksum How to use checksums |
ddd68fc7bfb4b7a192ba4e2e679d64fbb1ab1d6a180d02fa36144b5f14c735dd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Jan 2, 2026.
Transparency log