This repository contains quickstarts for SolverForge, an AI constraint solver and framework for Rust and Python. It shows different use cases and basic implementations of constraint solving. The legacy (Timefold-based) quicktarts have been moved to legacy.
| Use Case |
Notable Solver Concepts |
|---|---|
| 🚚 Vehicle Routing | Chained Through Time, Shadow Variables |
| 🧑💼 Employee Scheduling | Load Balancing |
| 🛠️ Maintenance Scheduling | TimeGrain, Shadow Variable, Variable Listener |
| 🛒 Order Picking | Chained Planning Variable, Shadow Variables |
| 👥 Meeting Scheduling | TimeGrain |
Note
The implementations in this repository serve as a starting point and/or inspiration when creating your own application. SolverForge is a library and does not include a UI. To illustrate these use cases a rudimentary UI is included in these quickstarts.
Find the most efficient routes for vehicles to reach visits, considering vehicle capacity and time windows when visits are available. Sometimes also called "CVRPTW".
- Run vehicle-routing (Python, FastAPI)
- Run vehicle-routing (fast) (Python, FastAPI)
Tip
Schedule shifts to employees, accounting for employee availability and shift skill requirements.
- Run employee-scheduling (Python, FastAPI)
- Run employee-scheduling (fast) (Python, FastAPI)
Tip
Schedule maintenance jobs to crews over time to reduce both premature and overdue maintenance.
- Run maintenance-scheduling (Python, FastAPI)
Generate an optimal picking plan for completing a set of orders.
- Run order-picking (Python, FastAPI)
Assign timeslots and rooms for meetings to produce a better schedule.
- Run meeting-scheduling (Python, FastAPI)
- Run meeting-scheduling (fast) (Python, FastAPI)
This version of SolverForge is inspired on a repo that was forked on 03 August 2025 from the original Timefold Quickstarts, which was entirely Apache-2.0 licensed (a permissive license). Derivative work is limited to the legacy/ folder and the original fork is available as an archive.
The original Timefold Quickstarts was forked on 20 April 2023 from OptaPlanner Quickstarts.
This version of SolverForge Quickstarts is inspired on the original Timefold Quickstarts and OptaPlanner Quickstarts, which includes copyrights of the original creators, Timefold AI, Red Hat Inc., affiliates, and contributors, that were all entirely licensed under the Apache-2.0 license, for the legacy/ folder exclusively. Every source file has been modified.