chess puzzles
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.