Installation

EpiBenchmark uses a standard Python installation flow. All functionality, including forecast scoring, runs within the installed Python environment.

Requirements

• Python 3.10 or later
• Git

Quick Start

git clone https://github.com/ACCIDDA/EpiBenchmark.git
cd EpiBenchmark
uv sync
uv run epibench --help

Installation

Clone the repository:

git clone https://github.com/ACCIDDA/EpiBenchmark.git

cd EpiBenchmark

EpiBenchmark supports installation using either uv (recommended) or pip.

Option 1: Install with uv

This is the fastet installation method.

uv sync

Activate the virtual environment

Windows

.venv\Scripts\activate

macOS/Linux

source .venv/bin/activate

Alternatively, users can run commands without activating the virtual environment when using uv:

uv run epibench --help

Option 2: Install with pip

Create a virtual environment.

Windows

python -m venv .venv
.venv\Scripts\activate

macOS/Linux

python -m venv .venv
source .venv/bin/activate

Upgrade pip:

python -m pip install --upgrade pip

Install EpiBenchmark in editable mode:

python -m pip install -e .

Verify the Installation

After installation, verify that the command-line interface is available:

epibench
epibench --help

Users can also verify the available subcommands:

epibench create --help
epibench score --help
epibench plot --help

Remove the virtual environment

Deletes the local .venv directory, allowing users to create a fresh virtual environment.

Windows

If Command Prompt:

rmdir /s /q .venv 

If PowerShell:

Remove-Item -Recurse -Force .venv (PowerShell)

macOS/Linux

rm -rf .venv