pyepo 1.3.0

PyTorch-based End-to-End Predict-then-Optimize Tool

PyEPO: A PyTorch-based End-to-End Predict-then-Optimize Tool

PyEPO (PyTorch-based End-to-End Predict-then-Optimize Tool) is a Python-based, open-source software that supports modeling and solving predict-then-optimize problems with linear objective functions. The core capability of PyEPO is to build optimization models with GurobiPy, COPT, Pyomo, Google OR-Tools, MPAX, or any other solvers and algorithms, then embed the optimization model into an artificial neural network for the end-to-end training. For this purpose, PyEPO implements various methods as PyTorch autograd modules.

Features

• Implement SPO+, DBB, NID, DPO (additive and multiplicative perturbations), PFYL (additive and multiplicative perturbations), L2-regularized RFWO/RFYL, NCE, LTR, I-MLE, AI-MLE, and PG
• Support Gurobi, COPT, Pyomo, Google OR-Tools, and MPAX API
• Support parallel computing for optimization solvers
• Support solution caching to speed up training
• Support kNN robust loss to improve decision quality

GPU-Accelerated Solving with MPAX

PyEPO integrates MPAX, a JAX-based mathematical programming solver using the PDHG algorithm for GPU-accelerated optimization. Key advantages: (1) GPU-native solving — the first-order PDHG method runs efficiently on GPU; (2) batch solving — an entire mini-batch can be solved simultaneously via vectorization; (3) no GPU-CPU data transfer overhead — both the neural network and the solver stay on GPU, eliminating the data transfer bottleneck.

Documentation

The official docs can be found at https://khalil-research.github.io/PyEPO.

Publication

PyEPO: A PyTorch-based End-to-End Predict-then-Optimize Library for Linear and Integer Programming (Mathematical Programming Computation)