HOLMES

ci holmes ci holmes-rs holmes-hydro pypi version holmes-rs pypi version Supported Python Version Documentation

HOLMES (HydrOLogical Modeling Educational Software) is a software developed to teach operational hydrology. It is developed at Université Laval, Québec, Canada.

📖 Documentation · 📦 PyPI

The dashboard guides students through a modeling pipeline — stations → weather → model → calibration → simulation → projection — starting from an interactive map of hydrometric stations. The backend is Starlette, the frontend is vanilla JavaScript with an Elm architecture (d3 and Leaflet), and communication is mostly over WebSocket. All numerical computation runs in holmes-rs, a Rust extension.

Usage

Installation

pip install holmes-hydro

Running HOLMES

After installation, start the dashboard with:

holmes run

The web interface will be available at http://127.0.0.1:8000.

Other commands:

holmes download     # rebuild the published datasets from their true sources
holmes experiment   # run batch calibration experiments

Station, weather, and projection data are fetched from their true sources at runtime and cached under data/; prebuilt products are served from the repo so a fresh install works without any credentials.

Configuration

Customize the server by creating a .env file:

DEBUG=True          # Enable debug mode (default: False)
RELOAD=True         # Enable auto-reload on code changes (default: False)
HOST=127.0.0.1      # Server host (default: 127.0.0.1)
PORT=8000           # Server port (default: 8000)

Development

Setup

  1. Install uv:

    curl -LsSf https://astral.sh/uv/install.sh | sh

  2. Clone and install in development mode:

    git clone https://github.com/antoinelb/holmes.git
cd holmes
uv sync

Running

uv run holmes run

Or activate the virtual environment and run directly:

source .venv/bin/activate
holmes run

Code Quality

make static-analysis

Tests

make test       # unit + integration (100% coverage) and the Rust suites
make test-e2e   # Playwright end-to-end tests

References

Project links

Data verified by PyPI on Aug 15, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (4.5.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for antoinelb from gravatar.com antoinelb

Credits

Author: Antoine Lefebvre-Brossard

GitHub Statistics

Data verified by PyPI on Aug 15, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT

Requires

Python >=3.12

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

holmes_hydro-4.2.1.tar.gz (37.0 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

holmes_hydro-4.2.1-py3-none-any.whl (311.3 kB view details)

Uploaded Python 3

File details

Details for the file holmes_hydro-4.2.1.tar.gz.

File metadata

  • Download URL: holmes_hydro-4.2.1.tar.gz
  • Upload date:
  • Size: 37.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for holmes_hydro-4.2.1.tar.gz
Algorithm Hash digest
SHA256 dbcbfb4f70c8bfb2dd9b671bc3466665e26705406145363a26a4e66a7b8352f3
MD5 bb2cfd8813e3c4b520d7b23d10a7f2b7
BLAKE2b-256 223dad8eb7a8bd82eb83a341f6f1f1026d2e2a9e89b609633a28b522a2342cf9

See more details on using hashes here.

Provenance

The following attestation bundles were made for holmes_hydro-4.2.1.tar.gz:

Publisher: ci-holmes.yml on antoinelb/holmes

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file holmes_hydro-4.2.1-py3-none-any.whl.

File metadata

  • Download URL: holmes_hydro-4.2.1-py3-none-any.whl
  • Upload date:
  • Size: 311.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for holmes_hydro-4.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 97f79ed8db59d949a5beffe62653db297ccb786c36d117750a105e60d094fbad
MD5 514e21547c525fb639e5ac71b3a3019c
BLAKE2b-256 a20cdf6568aee9d4ed7b4e0c1a7829c522433554b9e5a47ebbe4cd37159a97e5

See more details on using hashes here.

Provenance

The following attestation bundles were made for holmes_hydro-4.2.1-py3-none-any.whl:

Publisher: ci-holmes.yml on antoinelb/holmes

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

4.5.1

2 files

4.5.0

2 files

4.4.0

2 files

4.3.0

2 files

This release

4.2.1 This release

2 files

4.1.0

2 files

4.0.0

2 files

3.5.0

2 files

3.4.4

2 files

3.4.3

2 files

3.4.2

2 files

3.4.1

2 files

3.4.0

2 files

3.3.8

2 files

3.3.7

2 files

3.3.6

2 files

3.3.5

2 files

3.3.4

2 files

3.3.3

2 files

3.3.2

2 files

3.3.1

2 files

3.3.0

2 files

3.2.5

2 files

3.2.2

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page