Docs
  • Solver
  • Models
    • Field Service Routing
    • Employee Shift Scheduling
  • Platform
Try models
  • Timefold Solver 1.22.1
  • Introduction
  • 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

Introduction

Every organization faces planning problems: providing products or services with a limited set of constrained resources (employees, assets, time, and money). Timefold Solver’s PlanningAI optimizes these problems to do more business with fewer resources using Constraint Satisfaction Programming.

This documentation provides guidance on using our open-source solver to build custom models from scratch. For common planning problems, we also offer ready-made models that can be seamlessly integrated via our REST API.

Explore our documentation and available models here

Timefold Solver is a lightweight, embeddable constraint satisfaction engine which optimizes planning problems. Example usecases include:

useCaseOverview
Figure 1. Timefold Solver’s use cases include vehicle routing, employee scheduling, rostering, bin packing, and equipment scheduling.

Timefold Solver is 100% pure JavaTM and runs on Java 17 or higher. It integrates very easily with other JavaTM, Python, and other technologies. Timefold Solver works on any Java Virtual Machine and is compatible with the major JVM languages and all major platforms. It also supports Kotlin and Python.

Next

  • Follow the Quickstart Example to tackle your first planning problem.

  • Learn about some important concepts used in the realm of PlanningAI.

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