Getting Started¶

Installation¶

Prerequisites¶

• Python 3.14+
• UV

Install¶

git clone https://github.com/jacksonpradolima/coleman4hcs.git
cd coleman4hcs
uv sync
uv pip install -e .

Development Setup¶

# Install all development dependencies
make install

# Install pre-commit hooks
make pre-commit-install

Configuration¶

1. Copy the example environment file:

cp .env.example .env

1. Edit .env and set CONFIG_FILE=./config.toml.

2. Customise config.toml to select datasets, policies, and reward functions.

Running Experiments¶

uv run python main.py

See the README for detailed usage instructions covering HCS strategies, contextual bandits, and dataset preparation.