TimefoldAI/timefold-solver

View on GitHub

The open source Solver AI for Java and Kotlin to optimize scheduling and routing. Solve the vehicle routing problem, employee rostering, task assignment, maintenance scheduling and other planning problems.

Stars: 1.8k
Forks: 228
Open beginner issues: 0
Indexed issues: 93
Avg merge: 1d 13h
Merged PRs (30d): 46

Dominant language: Java
License: Apache-2.0
Last GitHub push: Sep 17, 2026
Latest indexed: Sep 20, 2026
Contributing guide: Contributing guide
Code of conduct: No code of conduct
Beginner labels: No beginner labels indexed

Beginner friendly Everything

Open All

93 open issues indexed

Improvement: neighborhoods documentation Open

component/docs

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

TimefoldAI/timefold-solver#2671 · Opened Sep 17, 2026
Improvement: extra constructor for DemoMetaData Open

process/needs triage

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

TimefoldAI/timefold-solver#2652 · Opened Sep 9, 2026
Unify handling of unassigned values when unassigned not allowed Open

Difficulty 5/5 Over a week Newbie friendliness 35/100

TimefoldAI/timefold-solver#2647 · 1 reaction · Opened Sep 8, 2026
Generate timefold-build.properties in the correct maven module Open

component/service

Difficulty 3/5 1-2 days Newbie friendliness 66/100

TimefoldAI/timefold-solver#2629 · Opened Sep 1, 2026
docs: improve demo data documentation Open

component/docs

TimefoldAI/timefold-solver#2626 · 1 assignee · Opened Aug 31, 2026
Investigate a flaky test Open

TimefoldAI/timefold-solver#2578 · 1 assignee · Opened Aug 10, 2026
Getting started docs: make Timeslot a record too (not just Room) Open

TimefoldAI/timefold-solver#2592 · 1 comment · 1 assignee · Opened Jul 25, 2026
Consider removing the AbstractSimpleModel Open

component/service

Difficulty 5/5 Over a week Newbie friendliness 25/100

TimefoldAI/timefold-solver#2509 · 1 comment · Opened Jul 16, 2026
docs: restructure shared information Open

component/docs

Difficulty 3/5 1-2 days Newbie friendliness 52/100

TimefoldAI/timefold-solver#2499 · Opened Jul 15, 2026
Service SDK: ModelConfigOverrides records are forced to declare an all-null no-arg constructor Open

Difficulty 4/5 3-5 days Newbie friendliness 48/100

TimefoldAI/timefold-solver#2493 · 2 comments · Opened Jul 14, 2026
docs: rework constraint section Open

component/docs

TimefoldAI/timefold-solver#2474 · 1 assignee · Opened Jul 7, 2026
docs: describe ShadowVariable updating multiple fields Open

component/docs

TimefoldAI/timefold-solver#2472 · 1 assignee · Opened Jul 6, 2026
Shadow variable or predicate Pinning Open

process/needs triage

Difficulty 5/5 Over a week Newbie friendliness 25/100

TimefoldAI/timefold-solver#2471 · Opened Jul 6, 2026
Service: Add the option to validate a solution after solving Open

component/service process/needs triage

Difficulty 4/5 3-5 days Newbie friendliness 35/100

TimefoldAI/timefold-solver#2470 · Opened Jul 6, 2026
Service: Add support for validation of the planning solution Open

component/service

TimefoldAI/timefold-solver#2458 · 1 reaction · 1 assignee · Opened Jul 2, 2026
Docs: Terminology issue Open

component/docs

Difficulty 5/5 Over a week Newbie friendliness 35/100

TimefoldAI/timefold-solver#2446 · Opened Jun 30, 2026
Docs: Service - rewrite VRP Quickstart Guide Open

component/docs

TimefoldAI/timefold-solver#2428 · 1 assignee · Opened Jun 26, 2026
Service: OpenAPI validation fails Open

process/needs triage

TimefoldAI/timefold-solver#2394 · 3 comments · 1 assignee · Opened Jun 19, 2026
Enable clean cut-off by a versioned release branch Open

build and release

TimefoldAI/timefold-solver#2388 · 1 assignee · Opened Jun 19, 2026
Docs: Create Java configuration examples for the XML configuration examples. Open

component/docs

TimefoldAI/timefold-solver#2353 · 1 assignee · Opened Jun 10, 2026
Docs: Service - Describe maps component Open

component/docs

TimefoldAI/timefold-solver#2348 · 1 assignee · Opened Jun 10, 2026
Docs: Service - Adjusting Model Parameters Open

component/docs

TimefoldAI/timefold-solver#2347 · 1 assignee · Opened Jun 10, 2026
Allow @ShadowSources path to traverse through non-planning variables Open

process/needs triage

Difficulty 4/5 3-5 days Newbie friendliness 48/100

TimefoldAI/timefold-solver#2331 · 3 comments · Opened Jun 1, 2026
Upgrade JSon Schema Validator Open

dependencies technical-debt

TimefoldAI/timefold-solver#2330 · 2 comments · 1 assignee · Opened Jun 1, 2026
Random iteration over ComparisonIndexer is not fair Open

component/neighborhoods

Difficulty 3/5 1-2 days Newbie friendliness 64/100

TimefoldAI/timefold-solver#2325 · 1 comment · Opened May 30, 2026
Solver run information: what triggered termination Open

process/needs triage

TimefoldAI/timefold-solver#2319 · 3 comments · 1 assignee · Opened May 26, 2026
Investigate locking in AbstractStorageService Open

TimefoldAI/timefold-solver#2318 · 1 assignee · Opened May 26, 2026
Docs: real-time scheduling - daemon mode is no longer the best practice Open

component/docs

TimefoldAI/timefold-solver#2257 · 1 assignee · Opened Apr 22, 2026
Allow to disable value range check on ConstraintVerifier for Unit Test Open

process/needs triage

Difficulty 4/5 3-5 days Newbie friendliness 45/100

TimefoldAI/timefold-solver#2237 · Opened Apr 14, 2026
Allow SubListSwapMoveSelector to swap 1..n elements with 1..n unassigned elements Open

process/needs triage

Difficulty 5/5 Over a week Newbie friendliness 35/100

TimefoldAI/timefold-solver#2212 · 2 reactions · Opened Mar 25, 2026
Allow package-private planning domain classes and methods Open

Difficulty 4/5 3-5 days Newbie friendliness 48/100

TimefoldAI/timefold-solver#2160 · 6 comments · Opened Mar 4, 2026
Feat: planning variables outside of the value range should be allowed for pinned planning entities Open

process/needs triage

Difficulty 3/5 1-2 days Newbie friendliness 45/100

TimefoldAI/timefold-solver#2143 · 6 comments · Opened Feb 23, 2026
PlanningPin accessor method should support a solution as an optional argument Open

Difficulty 3/5 1-2 days Newbie friendliness 52/100

TimefoldAI/timefold-solver#2126 · 4 comments · Opened Feb 17, 2026
Docs: mention native (core Java) compatibility Open

component/docs

Difficulty 3/5 1-2 days Newbie friendliness 35/100

TimefoldAI/timefold-solver#2086 · Opened Feb 6, 2026
Docs: Improve documentation on MultiStageMoves Open

component/docs

Difficulty 4/5 3-5 days Newbie friendliness 30/100

TimefoldAI/timefold-solver#2083 · Opened Feb 6, 2026
Docs: Improve mixed model documentation Open

component/docs

Difficulty 4/5 3-5 days Newbie friendliness 35/100

TimefoldAI/timefold-solver#2078 · Opened Feb 5, 2026
Neighborhoods: Support for non-exhausting iteration Open

component/neighborhoods

Difficulty 5/5 Over a week Newbie friendliness 25/100

TimefoldAI/timefold-solver#2034 · Opened Jan 21, 2026
Neighborhoods: Profiling support Open

component/neighborhoods

Difficulty 5/5 Over a week Newbie friendliness 20/100

TimefoldAI/timefold-solver#2033 · Opened Jan 21, 2026
Neighborhoods: Automatic node-sharing support Open

component/neighborhoods

Difficulty 5/5 Over a week Newbie friendliness 25/100

TimefoldAI/timefold-solver#2032 · Opened Jan 21, 2026
Neighborhoods: Improve working with value ranges Open

process/needs triage

Difficulty 5/5 Over a week Newbie friendliness 25/100

TimefoldAI/timefold-solver#2021 · Opened Jan 16, 2026
feat: allow sourcing of declarative variables on values inside @PlanningListVariable and @InverseRelationShadowVariable Open

TimefoldAI/timefold-solver#2009 · 1 assignee · Opened Jan 9, 2026
Code formatting readme for IntelliJ: why still use the special plugin? Open

process/needs triage

Difficulty 2/5 1-3 hours Newbie friendliness 48/100

TimefoldAI/timefold-solver#1998 · 4 comments · Opened Dec 26, 2025
No longer rely on deep reflection in cloning Open

Difficulty 5/5 Over a week Newbie friendliness 20/100

TimefoldAI/timefold-solver#1929 · Opened Nov 18, 2025
perf: Node unlinking in Constraint Streams when it can be determined a constraint can never fire. Open

process/needs triage

Difficulty 5/5 Over a week Newbie friendliness 35/100

TimefoldAI/timefold-solver#1925 · Opened Nov 13, 2025
Need a way to filter out moves which would create inconsistent variables Open

component/neighborhoods

Difficulty 4/5 3-5 days Newbie friendliness 35/100

TimefoldAI/timefold-solver#1912 · 1 comment · Opened Nov 3, 2025
Quarkus application.properties code completion for the spent-limit properties in IntelliJ (regression) Open

process/needs triage

Difficulty 3/5 1-2 days Newbie friendliness 32/100

TimefoldAI/timefold-solver#1882 · Opened Oct 19, 2025
docs: enhance migration path docs for variable listeners Open

component/docs

Difficulty 3/5 1-2 days Newbie friendliness 48/100

TimefoldAI/timefold-solver#1835 · Opened Sep 26, 2025
docs: improve documentation for troubleshooting Open

component/docs

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

TimefoldAI/timefold-solver#1815 · 3 comments · Opened Sep 16, 2025
docs: improve docs around deep solver extensions Open

component/docs

TimefoldAI/timefold-solver#1801 · 1 assignee · Opened Sep 10, 2025
Detect the constraint causing a score corruption Open

process/needs triage

Difficulty 5/5 Over a week Newbie friendliness 25/100

TimefoldAI/timefold-solver#1791 · Opened Sep 9, 2025

TimefoldAI/timefold-solver

Get new issues in your inbox