datasets
Training and evaluation data, with the modality, task and licence stated up front. Listed live from the Hugging Face Hub.
chess-puzzleschess-puzzles
Dataset Card for Lichess Puzzles
Dataset Description
6,100,960 puzzles, rated and tagged. See them in action on Lichess.
This dataset is updated monthly, and was last updated on September 7th, 2026.
Dataset Creation
Generating the initial dataset chess puzzles took more than 50 years of CPU time. We went through 300,000,000 analyzed games from the Lichess database, and re-analyzed interesting positions with Stockfish 12/13/14/15 NNUE at 40… See the full description on the dataset page: https://huggingface.co/datasets/Lichess/chess-puzzles.chess-puzzles-images-mini
Dataset Card for Chess Puzzles Images (mini)
This dataset contains 124,999 chess board positions in JPG format, derived from Lichess puzzles. Each image is accompanied by a shortened FEN string, indication for the color to play as, castling and en passant availability, and best moves in standard algebraic notation.
The fields are as follows:
image: image, A visual representation of the chess board showing the current piece arrangement.
board_state: string, A shortened FEN… See the full description on the dataset page: https://huggingface.co/datasets/bingbangboom/chess-puzzles-images-mini.chess-puzzles-images-large
Dataset Card for Chess Puzzles Images (large)
This dataset contains 1,249,999 chess board positions in JPG format, derived from Lichess puzzles. Each image is accompanied by a shortened FEN string, indication for the color to play as, castling and en passant availability, and best moves in standard algebraic notation.
The fields are as follows:
image: image, A visual representation of the chess board showing the current piece arrangement.
board_state: string, A shortened FEN… See the full description on the dataset page: https://huggingface.co/datasets/bingbangboom/chess-puzzles-images-large.chess-puzzles-with-games
[!CAUTION]
This dataset is still a work in progress. Expect breaking changes.
This dataset was contributed by Marco Cognetta. The original archived repository describing the project can be found here: https://github.com/mcognetta/lichess-combined-puzzle-game-db
Background
This contains every puzzle from the Lichess Puzzle Database joined with their games from the Lichess Game Database. The puzzle data was pulled in September 2022. There are 2,969,948 puzzles in total. The… See the full description on the dataset page: https://huggingface.co/datasets/Lichess/chess-puzzles-with-games.chess_puzzles_10k_in_pgn_san
Lichess Puzzle Database …
Lichess Puzzle Database ▸ Mate‑in‑1/2/3 Subset
A 10k slice of the official Lichess puzzle corpus.
Note: The board is updated to the position that arises after the opponent blunders.
Source
Original dataset: https://huggingface.co/datasets/Lichess/chess-puzzles
What’s Inside
Category
Count
Mate‑in‑1
3333
Mate‑in‑2
3333
Mate‑in‑3
3333
Total
9999
Format Improvements
Field
Old
New… See the full description on the dataset page: https://huggingface.co/datasets/quantum24/chess_puzzles_10k_in_pgn_san.chess-puzzles-san
Dataset Card for Chess Puzzles (SAN)
4,130,824 chess puzzles from Lichess with moves converted to standard algebric notation.
Puzzles are formatted as standard CSV. The fields are as follows:
PuzzleId,new_FEN,best_Moves,Rating,RatingDeviation
PuzzleId: string, the puzzle's unique identifier. The puzzle would be live at https://lichess.org/training/{PuzzleID}.
new_FEN: string, the FEN string of the position after the opponent has made their move. It is now player's turn to make… See the full description on the dataset page: https://huggingface.co/datasets/bingbangboom/chess-puzzles-san.chess-puzzles
Dataset Card for Lichess Puzzles
Dataset Description
5,600,086 chess puzzles, rated and tagged. See them in action on Lichess.
This dataset is updated monthly, and was last updated on December 17th, 2025.
Dataset Creation
Generating the initial dataset chess puzzles took more than 50 years of CPU time. We went through 300,000,000 analyzed games from the Lichess database, and re-analyzed interesting positions with Stockfish 12/13/14/15 NNUE at 40 meganodes.… See the full description on the dataset page: https://huggingface.co/datasets/tony808ipi/chess-puzzles.chess_puzzles_1k_in_pgn_san
Lichess Puzzle Database …
Lichess Puzzle Database ▸ Mate‑in‑1/2/3 Subset
A 1k slice of the official Lichess puzzle corpus. 10k soon!
Note: The board is updated to the position that arises after the opponent blunders.
Source
Original dataset: https://huggingface.co/datasets/Lichess/chess-puzzles
What’s Inside
Category
Count
Mate‑in‑1
333
Mate‑in‑2
333
Mate‑in‑3
333
Total
999
Format Improvements
Field
Old
New… See the full description on the dataset page: https://huggingface.co/datasets/quantum24/chess_puzzles_1k_in_pgn_san.chess-puzzles-evchess-puzzleschess-puzzles-rlvr
Dataset Card: Chess-Puzzles-RLVR
Dataset Summary
This dataset is a highly processed and stratified collection of approximately 5 million chess puzzles, ranging from Elo ratings of 400 to 3300. It is specifically designed for Curriculum Learning and Reinforcement Learning (RLVR) agents.
Unlike standard puzzle datasets, this version is pre-sorted and split into "rating buckets" to ensure that training, validation, and testing sets maintain an identical difficulty… See the full description on the dataset page: https://huggingface.co/datasets/codingmonster1234/chess-puzzles-rlvr.chess-debate-puzzles
Chess Debate Puzzles
A stratified sample of Lichess mid/endgame chess puzzles annotated with Stockfish-evaluated
moves across ten centipawn-quality bands. Designed for experiments in the spirit of
AI Safety via Debate (Irving et al., 2018), where two AI
agents argue for different moves and a judge must identify the objectively better one.
Motivation
Debate as an alignment technique asks whether a human (or AI) judge can identify the correct
answer when two agents argue… See the full description on the dataset page: https://huggingface.co/datasets/kvoudouris/chess-debate-puzzles.chess-puzzles
Dataset Card for Lichess Puzzles
Dataset Description
5,600,086 chess puzzles, rated and tagged. See them in action on Lichess.
This dataset is updated monthly, and was last updated on December 17th, 2025.
Dataset Creation
Generating the initial dataset chess puzzles took more than 50 years of CPU time. We went through 300,000,000 analyzed games from the Lichess database, and re-analyzed interesting positions with Stockfish 12/13/14/15 NNUE at 40 meganodes.… See the full description on the dataset page: https://huggingface.co/datasets/arindam2025/chess-puzzles.chess_puzzles_datasetchess-puzzles-with-games
[!CAUTION]
This dataset is still a work in progress. Expect breaking changes.
This dataset was contributed by Marco Cognetta. The original archived repository describing the project can be found here: https://github.com/mcognetta/lichess-combined-puzzle-game-db
Background
This contains every puzzle from the Lichess Puzzle Database joined with their games from the Lichess Game Database. The puzzle data was pulled in September 2022. There are 2,969,948 puzzles in total. The game… See the full description on the dataset page: https://huggingface.co/datasets/coryvegan/chess-puzzles-with-games.chess-puzzles
Dataset Card for Lichess Puzzles
Dataset Description
5,829,565 puzzles, rated and tagged. See them in action on Lichess.
This dataset is updated monthly, and was last updated on March 25th, 2026.
Dataset Creation
Generating the initial dataset chess puzzles took more than 50 years of CPU time. We went through 300,000,000 analyzed games from the Lichess database, and re-analyzed interesting positions with Stockfish 12/13/14/15 NNUE at 40 meganodes. The… See the full description on the dataset page: https://huggingface.co/datasets/coryvegan/chess-puzzles.chess_puzzleschess-puzzles-815Kchess-puzzles-20kchess-puzzleschess_puzzles_openai_paperchess-puzzles-hanging-40kchess-puzzles-data