Practical overview
When it fits
Use Hypster when Python workflow settings need reusable structure, conditional choices or typed parameters, or when those parameters should feed an Optuna search.
Who it is for
- Python developers managing configuration across machine-learning experiments.
- Teams composing nested or conditional model and workflow settings.
- Practitioners connecting configurable parameters to Optuna searches.
Documented uses
- Define reusable configuration functions with selectable and bounded parameters.
- Inspect configuration structure or a conditional branch before creating an object.
- Instantiate configured objects with explicit value overrides.
- Map configuration parameters into Optuna trials for hyperparameter search.
Requirements & limits
The repository identifies the project as open source under the MIT license. Installation instructions include uv and link to guidance for pip.
- The framework configures Python objects; model training and scoring remain part of the user's own objective code.
- Optuna support is provided as an optional installation extra.
- A separate optional extra is documented for notebook visualization.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install Hypster with optional Optuna support
Add the framework and its documented Optuna integration to a Python project.
Before you start
- A Python project using uv.
Steps
Add the base package with the command below.
uv add hypsterAdd the optional hyperparameter-optimization extra with the command below.
uv add 'hypster[optuna]'
Expected outcome
The project declares Hypster and its optional Optuna backend.
Guide limitations
- This covers package installation only, not configuring or running an optimization study.
Define and inspect a model configuration
Create a Python configuration function, inspect its choices, and instantiate an object with overrides.
Before you start
- Hypster installed in the Python project.
- A configuration function that accepts an
HPargument and returns the object to configure.
Steps
Import
HP,exploreandinstantiatefromhypster.Define a configuration function using Hypster parameter helpers such as
select,floatorint.Call
exploreon the function to inspect its configuration; pass values to inspect a conditional branch if needed.Call
instantiatewith the function and avaluesmapping of overrides.
Expected outcome
The function’s configuration can be inspected and used to construct an object with chosen values.
Guide limitations
- The configuration function and any returned application or model object must be supplied by the user.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 14 October 2026
- Original website title
- gilad-rubin/hypster · Official homepage title · retained in its source language

