holmes-hydro 3.3.1

HOLMES (HydrOLogical Modeling Educationnal Software) is a software developped to teach operational hydrology. It is developed at the university Laval, Québec, Canada.

HOLMES

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

Usage

Installation

pip install holmes-hydro

Running HOLMES

After installation, start the server with:

holmes

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

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://gitlab.com/antoinelb/holmes.git
   cd holmes
   uv sync
   

Running

uv run holmes

Or activate the virtual environment and run directly:

source .venv/bin/activate
holmes

Testing

uv run pytest

Code Quality

uv run black src/ tests/
uv run ruff check src/ tests/
uv run ty check src/

References

• Bucket Model