Skip to content
Projects

TimefoldAI/timefold-quickstarts

View on GitHub

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.

How these counts are measured

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.

AI

README.md

Original

Timefold Solver

GitHub Discussions

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.

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.

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".

Vehicle Routing Screenshot

[!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.

Employee Scheduling Screenshot

[!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.

Maintenance Scheduling Screenshot


📦 Food Packaging

Schedule food packaging orders to manufacturing lines to minimize downtime and fulfill all orders on time.

Food Packaging Screenshot


🛒 Order Picking

Generate an optimal picking plan for completing a set of orders.

Order Picking Screenshot


🏫 School Timetabling

Assign lessons to timeslots and rooms to produce a better schedule for teachers and students.

School Timetabling Screenshot

Without a UI:


🏭 Facility Location Problem

Pick the best geographical locations for new stores, distribution centers, COVID test centers, or telecom masts.

Facility Location Screenshot


🎤 Conference Scheduling

Assign conference talks to timeslots and rooms to produce a better schedule for speakers.

Conference Scheduling Screenshot


🛏️ Bed Allocation Scheduling

Assign beds to patient stays to produce a better schedule for hospitals.

Bed Scheduling Screenshot


🛫 Flight Crew Scheduling

Assign crew to flights to produce a better schedule for flight assignments.

Flight Crew Scheduling Screenshot


👥 Meeting Scheduling

Assign timeslots and rooms for meetings to produce a better schedule.

Meeting Scheduling Screenshot


✅ Task Assigning

Assign employees to tasks to produce a better plan for task assignments.

Task Assigning Screenshot


📆 Project Job Scheduling

Assign jobs for execution to produce a better schedule for project job allocations.

Project Job Scheduling Screenshot


🏆 Sports League Scheduling

Assign rounds to matches to produce a better schedule for league matches.

Sports League Scheduling Screenshot


🏅 Tournament Scheduling

Tournament Scheduling service assigning teams to tournament matches.

Tournament Scheduling Screenshot


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.