Docs
  • Solver
  • Models
    • Field Service Routing
    • Employee Shift Scheduling
  • Platform
Try models
  • Timefold Solver 1.22.1
  • Getting Started
  • Overview
  • Edit this Page
  • latest
    • latest
    • 0.8.x

Timefold Solver 1.22.1

    • Introduction
    • PlanningAI Concepts
    • Getting Started
      • Overview
      • Hello World Quick Start Guide
      • Quarkus Quick Start Guide
      • Spring Boot Quick Start Guide
      • Vehicle Routing Quick Start Guide
    • Using Timefold Solver
      • Using Timefold Solver: Overview
      • Configuring Timefold Solver
      • Modeling planning problems
      • Running Timefold Solver
      • Benchmarking and tweaking
    • Constraints and Score
      • Constraints and Score: Overview
      • Score calculation
      • Understanding the score
      • Adjusting constraints at runtime
      • Load balancing and fairness
      • Performance tips and tricks
    • Optimization algorithms
      • Optimization Algorithms: Overview
      • Construction heuristics
      • Local search
      • Exhaustive search
      • Move Selector reference
    • Responding to change
    • Integration
    • Design patterns
    • FAQ
    • New and noteworthy
    • Upgrading Timefold Solver
      • Upgrading Timefold Solver: Overview
      • Upgrade to the latest version
      • Upgrade from OptaPlanner
      • Backwards compatibility
    • Enterprise Edition

Overview

This documentation covers our Open Source solver to build a model from scratch. We also provide off-the-shelf models to solve common planning problems. These can be found here.

Each quick start guide gets you up and running with Timefold Solver quickly. Pick one that aligns with your requirements:

  • Hello World

    • Build a simple Java, Python or Kotlin application that uses Timefold Solver to optimize a school timetable for students and teachers.

  • Quarkus

    • Build a REST application with Java or Kotlin that uses Timefold Solver to optimize a school timetable for students and teachers.

    • Quarkus is a popular platform in the Java ecosystem that supports native compilation.

  • Spring Boot

    • Build a REST application with Java or Kotlin that uses Timefold Solver to optimize a school timetable for students and teachers.

    • Spring Boot is a popular platform in the Java ecosystem that supports native compilation.

All three quick starts use Timefold Solver to optimize a school timetable for student and teachers:

The timefold-quickstarts repository contains the source code for all these guides and more.
schoolTimetablingInputOutput

You can also find out how to build Vehicle Routing with Quarkus.

For other use cases, take a look at the timefold-quickstarts Github repository.

  • © 2025 Timefold BV
  • Timefold.ai
  • Documentation
  • Changelog
  • Send feedback
  • Privacy
  • Legal
    • Light mode
    • Dark mode
    • System default