Learning with Combinatorial Optimization Layers: a Probabilistic Approach
Abstract
Domain fit: AI-adjacent · Paper appears method- or tooling-adjacent to AI workflows with partial ecosystem coverage.
Combinatorial optimization (CO) layers in machine learning (ML) pipelines are a powerful tool to tackle data-driven decision tasks, but they come with two main challenges. First, the solution of a CO problem often behaves as a piecewise constant function of its objective parameters. Given that ML pipelines are typically trained using stochastic gradient descent, the absence of slope information is very detrimental. Second, standard ML losses do not work well in combinatorial settings. A growing body of research addresses these challenges through diverse methods. Unfortunately, the lack of well-maintained implementations slows down the adoption of CO layers. In this paper, building upon previous works, we introduce a probabilistic perspective on CO layers, which lends itself naturally to approximate differentiation and the construction of structured losses. We recover many approaches from the literature as special cases, and we also derive new ones. Based on this unifying perspective, we present InferOpt.jl, an open-source Julia package that 1) allows turning any CO oracle with a linear objective into a differentiable layer, and 2) defines adequate losses to train pipelines containing such layers. Our library works with arbitrary optimization algorithms, and it is fully compatible with Julia's ML ecosystem. We demonstrate its abilities using a pathfinding problem on video game maps as guiding example, as well as three other applications from operations research.
Results and benchmarks
Combinatorial optimization (CO) layers in machine learning (ML) pipelines are a powerful tool to tackle data-driven decision tasks, but they come with two main challenges.
Benchmark evidence is limited
Evidence graph: 3 refs, 3 links.
Utility signals: depth 60/100, grounding 75/100, status medium.
Implementation
Best maintained implementation now
Combinatorial optimization layers for machine learning pipelines
132 stars · 5 forks · Last push Aug 20, 2026 · MIT license
- License
- CI
- Dependencies
- Docker
Official implementation from Papers with Code · Repository link is mentioned in the paper metadata · Strong overlap with paper title keywords
axelparmentier/inferopt.jl is the strongest maintained implementation based on ranking signals. CI workflows are present. License is declared (MIT).
Open axelparmentier/inferopt.jl- Dependency manifest is missing
- Selected axelparmentier/inferopt.jl as the strongest maintained implementation for new work.
- Includes CI workflow signals.
- Repository activity is within the last 24 months.
- Official repository is preserved separately as historical context.
Compare implementation paths
Compare maintenance quality, reproducibility coverage, and evidence confidence before choosing a reproduction baseline.
- Maintenance
- Active
- Confidence
- High
- Reproducibility
- Moderate
- Stars
- 132
- Last push
- Aug 20, 2026 (5d)
Official implementation from Papers with Code · Repository link is mentioned in the paper metadata
- No Docker setup
- Dependency manifest missing
- Maintenance
- Stale risk
- Confidence
- High
- Reproducibility
- Moderate
- Stars
- 5
- Last push
- Feb 3, 2026 (202d)
Official implementation from Papers with Code · Repository link is mentioned in the paper metadata
- No Docker setup
- Dependency manifest missing
- Maintenance
- Stale
- Confidence
- Medium
- Reproducibility
- Moderate
- Stars
- 4
- Last push
- May 19, 2025 (462d)
Official implementation from Papers with Code
- No push in 12+ months
- No tagged releases
- No Docker setup
Reproduction readiness
Major work
No dependency manifest, manual reconstruction required
- axelparmentier/inferopt.jl has no requirements.txt, environment.yml, pyproject.toml, or Dockerfile.
- You will need to reverse-engineer dependencies from import statements in the source code.
Hardware requirements
- Expect multi-day setup/compute for meaningful reproduction based on current guidance.
Validation caveat
Framework baselines
- PyTorch Adam optimizer docs
Reference implementation of Adam in PyTorch.
- Optax Adam optimizer docs
JAX/Flax baseline for Adam variants.
- Keras Adam optimizer docs
TensorFlow/Keras baseline for Adam.
Repositories and ecosystem
Official
- LouisBouvier/WarcraftShortestPaths.jlConfidence: Medium
LouisBouvier/WarcraftShortestPaths.jl
4 stars · 1 forks · Last push May 19, 2025 · MIT license
- axelparmentier/MinimumWeightTwoStageSpanningTree.jlConfidence: High
Minimum Weight Two Stage Spanning tree: Mathematical Programming algorithms and Combinatorial Optimization Layers in ML pipelines
4 stars · 0 forks · Last push Apr 5, 2023 · MIT license
Community
No additional community repositories detected yet.
These repositories had low-confidence matching signals and are hidden by default.
- khalil-research/PyEPO
Confidence: Low · 685 stars
Hugging Face artifacts
No direct paper-linked artifacts were found. Showing strongest curated related artifacts for faster exploration.
Models
No trustworthy models matches right now.
Search models on Hugging FaceDatasets
- tomyimkc/repro-probabilistic-bisection-algorithm-provably-achieves-exponential-convergence-traces
79 downloads · 0 likes · Updated Jul 27, 2026
- ddasilva/probabilistic-solar-wind
55 downloads · 0 likes · Updated Apr 22, 2026
Spaces
Research context
Tasks
None detected
Methods
Stochastic optimization, QUBO / Combinatorial optimization
Domains
Computer vision
Open this paper in HFEPX to review benchmark signals, evaluation modes, and human-feedback protocol context.
Open in HFEPXJump to Paper2Code search queries derived from this paper's research context.
Data includes links from Papers with Code ( CC-BY-SA-4.0 ).