Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|
This repository contains quickstarts for Timefold Solver, an AI constraint solver for Java and Kotlin. It shows different use cases and basic implementations to get you started on your optimization journey.
| Use Case | Notable Solver Concepts |
|---|---|
| 🚚 Vehicle Routing | Chained Through Time, Shadow Variables |
| 🧑 Employee Scheduling | Load Balancing |
| 🛠️ Maintenance Scheduling | TimeGrain, Shadow Variable, Variable Listener |
| 📦 Food Packaging | Mixed Model, Shadow Variables, Pinning |
| 🛒 Order Picking | Chained Planning Variable, Shadow Variables |
| 🏫 School Timetabling | Timeslot |
| 🏭 Facility Location Problem | Shadow Variable |
| 🎤 Conference Scheduling | Timeslot, Justifications |
| 🛏️ Bed Allocation Scheduling | Allows Unassigned |
| 🛫 Flight Crew Scheduling | |
| 👥 Meeting Scheduling | TimeGrain |
| ✅ Task Assigning | Bendable Score, Chained Through Time, Allows Unassigned |
| 📆 Project Job Scheduling | Shadow Variables, Variable Listener, Strenght Comparator |
| 🏆 Sports League Scheduling | Consecutive Sequences |
| 🏅 Tournament Scheduling | Pinning, Load Balancing |
Note
The implementations in this repository serve as a starting point and/or inspiration when creating your own application. Timefold Solver is a library and does not include a UI. To illustrate these use cases a rudimentary UI is included in these quickstarts.
Our website contains several getting started guides. All of them build the School Timetabling use case. You can find the resulting projects for each of the guides in the getting started folder.
- Service (Java, Maven, Quarkus)
- Library: Core (Java, Maven)
- Library: Quarkus Integration (Java, Maven, Quarkus)
- Library: Quarkus Integration (Kotlin, Maven, Quarkus)
- Library: Spring Boot Integration (Java, Maven, Spring)
Find the most efficient routes for vehicles to reach visits, considering vehicle capacity and time windows when visits are available. Sometimes also called "CVRPTW".
- View constraints
- Run quarkus-vehicle-routing (Java, Maven, Quarkus)
Tip
Check out our off-the-shelf model for Field Service Routing. This model goes beyond basic Vehicle Routing and supports additional constraints such as priorities, skills, fairness and more.
Schedule shifts to employees, accounting for employee availability and shift skill requirements.
- View constraints
- Run quarkus-employee-scheduling (Java, Maven, Quarkus)
Tip
Check out our off-the-shelf model for Employee Shift Scheduling. This model supports many additional constraints such as skills, pairing employees, fairness and more.
Schedule maintenance jobs to crews over time to reduce both premature and overdue maintenance.
- View constraints
- Run quarkus-maintenance-scheduling (Java, Maven, Quarkus)
Schedule food packaging orders to manufacturing lines to minimize downtime and fulfill all orders on time.
- View constraints
- Run quarkus-food-packaging (Java, Maven, Quarkus)
Generate an optimal picking plan for completing a set of orders.
- View constraints
- Run quarkus-order-picking (Java, Maven, Quarkus)
Assign lessons to timeslots and rooms to produce a better schedule for teachers and students.
- View constraints
- Run quarkus-school-timetabling (Java, Maven or Gradle, Quarkus)
- Run spring-boot-integration (Java, Maven or Gradle, Spring Boot)
- Run quarkus-integration-kotlin (Kotlin, Maven, Quarkus)
Without a UI:
- Service / REST API (Java, Maven, Quarkus)
- Library / Console Application (Java, Maven or Gradle)
Pick the best geographical locations for new stores, distribution centers, COVID test centers, or telecom masts.
- View constraints
- Run quarkus-facility-location (Java, Maven, Quarkus)
Assign conference talks to timeslots and rooms to produce a better schedule for speakers.
- View constraints
- Run quarkus-conference-scheduling (Java, Maven, Quarkus)
Assign beds to patient stays to produce a better schedule for hospitals.
- View constraints
- Run quarkus-bed-allocation-scheduling (Java, Maven, Quarkus)
Assign crew to flights to produce a better schedule for flight assignments.
- View constraints
- Run quarkus-flight-crew-scheduling (Java, Maven, Quarkus)
Assign timeslots and rooms for meetings to produce a better schedule.
- View constraints
- Run quarkus-meeting-scheduling (Java, Maven, Quarkus)
Assign employees to tasks to produce a better plan for task assignments.
- View constraints
- Run quarkus-task-assigning (Java, Maven, Quarkus)
Assign jobs for execution to produce a better schedule for project job allocations.
- View constraints
- Run quarkus-project-job-scheduling (Java, Maven, Quarkus)
Assign rounds to matches to produce a better schedule for league matches.
- View constraints
- Run quarkus-sports-league-scheduling (Java, Maven, Quarkus)
Tournament Scheduling service assigning teams to tournament matches.
- View constraints
- Run quarkus-tournament-scheduling (Java, Maven, Quarkus)
Timefold Quickstarts was forked on 20 April 2023 from OptaPlanner Quickstarts, which was entirely Apache-2.0 licensed (a permissive license).
Timefold Quickstarts is a derivative work of OptaPlanner Quickstarts, which includes copyrights of the original creator, Red Hat Inc., affiliates, and contributors, that were all entirely licensed under the Apache-2.0 license. Every source file has been modified.