TimefoldAI/timefold-quickstarts
TimefoldAI/timefold-quickstarts has 608 GitHub stars and 180 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 16:44 UTC. Last push 2026-11-13.
Measured star growth
- in 24h
- 0
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Get started with Timefold quickstarts here. Optimize the vehicle routing problem, employee rostering, task assignment, maintenance scheduling and other planning problems.
AIREADME.md
OriginalThis 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.
Overview
| Use Case | Notable Solver Concepts |
|---|---|
| 🚚 Vehicle Routing | Service Model, Map Integration, Planning List Variable, Shadow Variables |
| 🧑 Employee Scheduling | Load Balancing |
| 🛠️ Maintenance Scheduling | Service Model, TimeGrain, Shadow Variable, Variable Listener |
| 📦 Food Packaging | Service Model, Mixed Model, Shadow Variables, Pinning |
| 🛒 Order Picking | Chained Planning Variable, Shadow Variables |
| 🏫 School Timetabling | Timeslot |
| 🏭 Facility Location Problem | Service Model, Shadow Variable |
| 🎤 Conference Scheduling | Service Model, ValueRange on Entity, Timeslot, Justifications |
| 🛏️ Bed Allocation Scheduling | Service Model, Allows Unassigned, Pinning |
| 🛫 Flight Crew Scheduling | |
| 👥 Meeting Scheduling | Service Model, TimeGrain, Justifications |
| ✅ Task Assigning | Service Model, Chained Through Time, Allows Unassigned |
| 📆 Project Job Scheduling | Shadow Variables, Variable Listener, Strength Comparator |
| 🏆 Sports League Scheduling | Service Model, Consecutive Sequences, Justifications |
| 🏅 Tournament Scheduling | Service Model, 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.
Getting started implementations
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)
Use cases
🚚 Vehicle Routing
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.
🧑 Employee Scheduling
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.
🛠 Maintenance Scheduling
Schedule maintenance jobs to crews over time to reduce both premature and overdue maintenance.

- View constraints
- Run quarkus-maintenance-scheduling (Java, Maven, Quarkus)
📦 Food Packaging
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)
🛒 Order Picking
Generate an optimal picking plan for completing a set of orders.

- View constraints
- Run quarkus-order-picking (Java, Maven, Quarkus)
🏫 School Timetabling
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)
🏭 Facility Location Problem
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)
🎤 Conference Scheduling
Assign conference talks to timeslots and rooms to produce a better schedule for speakers.

- View constraints
- Run quarkus-conference-scheduling (Java, Maven, Quarkus)
🛏️ Bed Allocation Scheduling
Assign beds to patient stays to produce a better schedule for hospitals.

- View constraints
- Run quarkus-bed-allocation-scheduling (Java, Maven, Quarkus)
🛫 Flight Crew Scheduling
Assign crew to flights to produce a better schedule for flight assignments.

- View constraints
- Run quarkus-flight-crew-scheduling (Java, Maven, Quarkus)
👥 Meeting Scheduling
Assign timeslots and rooms for meetings to produce a better schedule.

- View constraints
- Run quarkus-meeting-scheduling (Java, Maven, Quarkus)
✅ Task Assigning
Assign employees to tasks to produce a better plan for task assignments.

- View constraints
- Run quarkus-task-assigning (Java, Maven, Quarkus)
📆 Project Job Scheduling
Assign jobs for execution to produce a better schedule for project job allocations.

- View constraints
- Run quarkus-project-job-scheduling (Java, Maven, Quarkus)
🏆 Sports League Scheduling
Assign rounds to matches to produce a better schedule for league matches.

- View constraints
- Run quarkus-sports-league-scheduling (Java, Maven, Quarkus)
🏅 Tournament Scheduling
Tournament Scheduling service assigning teams to tournament matches.

- View constraints
- Run quarkus-tournament-scheduling (Java, Maven, Quarkus)
Development
Want to contribute? See CONTRIBUTING.adoc.
Legal notice
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.