BilevelPy

Initial public alpha release of BilevelPy.

BilevelPy is an extensible Python framework for building, solving, and evaluating Gurobi-based optimization models, with built-in support for hub-location problems.

Highlights

• Composable variables and constraints with dependency validation
• Structured data loading and preprocessing pipelines
• Configurable Gurobi execution and structured solution extraction
• Built-in hub-location components and CAB benchmark datasets
• Documentation with tutorials, guides, an architecture overview, and API reference
• Automated test suite and CI for Python 3.11–3.14
• Poetry-based packaging with wheel validation
• Apache License 2.0

Installation

pip install bilevelpy

Requirements

• Python 3.11–3.14
• Gurobi Optimizer 11.0 or newer
• a valid Gurobi licence

BilevelPy is licensed separately from Gurobi. Installing BilevelPy does not provide a licence for Gurobi Optimizer.

Documentation

https://institute-of-transport-logistics.github.io/bilevelpy/

Release notes

See the complete CHANGELOG.md.

BilevelPy is currently an alpha release. Its public API may change before version 1.0.0.