Planning optimization made easy.
timefold.ai

Get started with Timefold Solver

• Read a Getting Started guide.

• Clone the Quickstarts repository.

Build from source

Build and run from source:

$ mvn clean install -Dquickly
$ cd examples
$ mvn exec:java

To develop with IntelliJ IDEA, Eclipse or VSCode, open the root pom.xml as a new project and configure a Run/Debug configuration like this:

• Type: Application

• Main class: ai.timefold.solver.examples.app.TimefoldExamplesApp

• VM options: -Xmx2G (memory only needed when using the big datasets in the examples)

• Program arguments: (none)

• Working directory: $MODULE_DIR$ (must resolve to examples directory)

• Use classpath of module: timefold-solver-examples

Contribute

This is an open source project, and you are more than welcome to contribute! ❤️

• Found an issue? Submit an issue.

• Want to fix an issue or contribute an improvement? Talk to us about your ideas or just start coding:

  1. Fork it.

  2. Create a feature branch: git checkout -b feature

  3. Commit your changes with a comment: git commit -m "Add some feature"

  4. Push to the branch to GitHub: git push origin feature

  5. Create a new Pull Request.

The CI checks against your PR to ensure that it doesn’t introduce errors. If the CI identifies a potential problem, our friendly PR maintainers will help you resolve it.

Code style

Your code is automatically formatted according to the Import and Code Style conventions during every Maven build. CI checks enforce those conventions too, so be sure to build your project with maven before creating your PR:

mvn clean install

For information about how to set up code style checks, see IDE Setup Instructions.

Build the Timefold Solver project

Use one of the following ways to build this project:

• 🚀 build-fast: mvn clean install -Dquickly skips any checks and code analysis (~1 min)

• 🔨 build-normally: mvn clean install runs tests, checks code style, skips documentation (~17 min)

• 🧾 build-doc: mvn clean install in the docs directory creates asciidoctor documentation docs/target/html_single/index.html (~2 min)

• 🦾 build-all: mvn clean install -Dfull runs all checks and creates documentation and distribution files (~20 min)

Notice

Timefold Solver is a fork of OptaPlanner (Apache-2.0 license). It’s a derivative work of OptaPlanner (as of 20 April 2023), which includes copyrights of Red Hat Inc. and affiliates, entirely licensed under the Apache-2.0 license (a permissive license). Every source file has been modified.