Fork me on GitHub

Download

OptaPlanner 9 (latest)

Distribution zip

The OptaPlanner distribution zip includes binaries, documentation, examples and sources.

Maven

The OptaPlanner jars are also available in the central maven repository (and also in the JBoss maven repository).

With Maven, just add the optaplanner-core dependency in your pom.xml to get started:

  <dependency>
    <groupId>org.optaplanner</groupId>
    <artifactId>optaplanner-core</artifactId>
    <version>9.38.0.Final</version>
  </dependency>

Or better yet, import the optaplanner-bom to avoid duplicating version numbers when adding other optaplanner dependencies later on:

<project>
  ...
  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>org.optaplanner</groupId>
        <artifactId>optaplanner-bom</artifactId>
        <type>pom</type>
        <version>9.38.0.Final</version>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.optaplanner</groupId>
      <artifactId>optaplanner-core</artifactId>
    </dependency>
    <dependency>
      <groupId>org.optaplanner</groupId>
      <artifactId>optaplanner-test</artifactId>
      <scope>test</scope>
    </dependency>
    ...
  </dependencies>
</project>

Gradle

With Gradle, just add the optaplanner-core dependency in your build.gradle to get started:

dependencies {
  implementation 'org.optaplanner:optaplanner-core:9.38.0.Final'
}

OptaPlanner 8 (legacy)

Both OptaPlanner 8 and 9 are equal feature-wise and their APIs have not changed. While OptaPlanner 9 brings compatibility with Jakarta EE 10, Quarkus 3 and Spring Boot 3, OptaPlanner 8 provides full backward compatibility for users who cannot migrate yet. OptaPlanner 8 will keep being released in parallel to OptaPlanner 9 until further notice.

If you are not sure which version to pick, see the following diagram:

Which OptaPlanner stream to choose?

To summarize what the diagram shows:

  • If you're starting a new project, or you don't use Quarkus or Spring Boot, we recommend using OptaPlanner 9.
  • Otherwise, stay on OptaPlanner 8, but plan for the migration. OptaPlanner 8 releases will end once enough users adopt Quarkus 3 or Spring Boot 3.

Distribution zip

The OptaPlanner distribution zip includes binaries, documentation, examples and sources.

Maven

The OptaPlanner jars are also available in the central maven repository (and also in the JBoss maven repository).

With Maven, just add the optaplanner-core dependency in your pom.xml to get started:

  <dependency>
    <groupId>org.optaplanner</groupId>
    <artifactId>optaplanner-core</artifactId>
    <version>8.38.0.Final</version>
  </dependency>

Or better yet, import the optaplanner-bom to avoid duplicating version numbers when adding other optaplanner dependencies later on:

<project>
  ...
  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>org.optaplanner</groupId>
        <artifactId>optaplanner-bom</artifactId>
        <type>pom</type>
        <version>8.38.0.Final</version>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.optaplanner</groupId>
      <artifactId>optaplanner-core</artifactId>
    </dependency>
    <dependency>
      <groupId>org.optaplanner</groupId>
      <artifactId>optaplanner-test</artifactId>
      <scope>test</scope>
    </dependency>
    ...
  </dependencies>
</project>

Gradle

With Gradle, just add the optaplanner-core dependency in your build.gradle to get started:

dependencies {
  implementation 'org.optaplanner:optaplanner-core:8.38.0.Final'
}

Non-Final releases

Non-Final releases are the best way to test drive new features and APIs to provide feedback before we lock down the API with a Final release. We welcome such feedback in our forum.

Alphas, Betas and CRs

An Alpha can be unstable. A Beta should work (it passes automated testing), but its new APIs might still change in the next release. A CR should be almost identical to the Final release.

There is no Alpha or Beta yet because we just released a Final version.

Nightly snapshots

Nightly snapshots are unstable binaries, built automatically by our CI server.

Older releases

For older community releases, check the release archive.

Latest release
Upcoming events
Latest blog posts
Latest videos