{"success":true,"data":{"author":"Lichess (lichess.org)","bucketAccessType":"public","bucketName":"Lichess/chess-puzzles","bucketPrefix":"","category":"Machine Learning & AI","cloudProvider":"huggingface","createdAt":"2026-11-14T14:15:20.081Z","description":"Tactical chess puzzles generated from real Lichess games, rated and tagged by theme. The card reports 6,157,341 puzzles, updated monthly. Generating the initial set took more than 50 years of CPU time: Lichess went through 300 million analysed games and re-analysed interesting positions with Stockfish 12 to 15 NNUE at 40 meganodes, then players solving the puzzles on lichess.org produced Glicko-2 ratings for them. Each row holds a puzzle id, the source game id and move, the starting position as FEN, the solution as UCI moves, the puzzle rating and rating deviation, popularity, number of plays, theme tags (fork, pin, mate in 2, endgame and so on) and opening tags. Listing data/ (measured 2026-11-14) shows three Parquet shards of about 0.3 GB. Uses include tactics training, measuring the reasoning ability of chess engines and language models, puzzle difficulty prediction, curriculum learning and studies of human problem solving. Load it with Hugging Face datasets, pandas or pyarrow and replay solutions with python-chess. Lichess releases its database exports under CC0.","displayTitle":"Lichess Chess Puzzles Database","id":"45023618-5555-5164-90c5-3d29952a286c","license":"CC0-1.0","licenseEvidenceUrl":"https://database.lichess.org/","objectCountEstimate":5,"probeStatus":"ok","region":"us","schemaCard":{"accessHints":[{"language":"python-datasets","snippet":"from datasets import load_dataset\nds = load_dataset(\"Lichess/chess-puzzles\")"},{"language":"python-hub","snippet":"from huggingface_hub import snapshot_download\nsnapshot_download(repo_id=\"Lichess/chess-puzzles\", repo_type=\"dataset\")"}],"caveats":["HuggingFace metadata: author=Lichess, license:cc0-1.0, size_categories:1M<n<10M, format:parquet, downloads=7602"],"format":"mixed","generatedAt":"2026-11-14T14:15:26.209Z","layout":{"example":"data/train-00000-of-00003.parquet","pattern":"{repoId}/{filename}"},"mountPath":"/mnt/archive","sampleHeaders":[{"bytes":"5041523115041590c580011582e34b4c1590a40e1500120000c8a2402005000000303030303811090044110900480d090438510d090439420d090450770d090453610d09045657110900630d09045a6f0d090461590d09006311630468300d120468660d09046a720d09046c430d09006d1112046f330d120470410d090471500d0904724f1109005a09090431340d2d083137520d1200380d2d083138530d120446670d090448690d09004b112d004f0db40831577a0d1b00580d750831614b0d1200630d99043167113f00680dd808316b470d24006d1187046f6d0d1200700dd8043175111b00752d68083177350d24007711870477621112116c00780dea0831786c091b0432430dd8083244730d1200472da7083248450d120448760d0900491112044b4a0d12044c4611092db904324d0dab08324f370d1b0451320d0900542da70432552def083255790d1b0056118700580dd808325a390d1b00622d320432650de10432652d2904326d2d29043270111b0472640d360475560d090076110904786809120433302d170433340da2083339540d1b0441580d0900454d7f0833494d0d120049111b004a113f00530dab083354780d2400552d050433592d170433614d2e0433632d5f0433650dea0433692d0e04336a6d2104336a115a006a2d7104336d0dcf04336d11bd006e2d9e04336f4dfd0433720dfc0433770d","encoding":"hex","key":"data/train-00000-of-00003.parquet","truncatedAt":512}],"sampleObjects":["data/train-00000-of-00003.parquet","data/train-00001-of-00003.parquet","data/train-00002-of-00003.parquet"],"sidecars":[{"bytes":"---\nlicense: cc0-1.0\nsize_categories:\n- 1M<n<10M\npretty_name: Lichess puzzles\ndataset_info:\n  features:\n  - name: PuzzleId\n    dtype: large_string\n  - name: GameId\n    dtype: string\n  - name: FEN\n    dtype: large_string\n  - name: Moves\n    dtype: large_string\n  - name: Rating\n    dtype: uint16\n  - name: RatingDeviation\n    dtype: uint16\n  - name: Popularity\n    dtype: int8\n  - name: NbPlays\n    dtype: uint32\n  - name: Themes\n    list: string\n  - name: OpeningTags\n    list: string\n  splits:\n  - name: train\n    num_bytes: 1256607736\n    num_examples: 6157341\n  download_size: 884570255\n  dataset_size: 1256607736\nconfigs:\n- config_name: default\n  data_files:\n  - split: train\n    path: data/train-*\ntags:\n- chess\n- lichess\n- puzzles\n---\n# Dataset Card for Lichess Puzzles\n\n<!-- Provide a quick summary of the dataset. -->\n## Dataset Description\n\n**6,157,341 puzzles**, rated and tagged. See them in action on [Lichess](https://lichess.org/training/themes). \n\nThis dataset is updated monthly, and was last updated on October 7th, 2026.\n\n### Dataset Creation\nGenerating 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 resulting puzzles were then [automatically tagged](https://github.com/ornicar/lichess-puzzler/tree/master/tagger). To determine the rating, each attempt to solve is considered as a Glicko-2 rated game between the player and the puzzle. Finally, player votes refine the tags and define popularity.\n\n\n### Dataset Usage\n\nUsing the `datasets` library:\n\n```python\nfrom datasets import load_dataset\ndset = load_dataset(\"Lichess/chess-puzzles\", split=\"train\")\n```\n\n## Dataset Details\n\n### Dataset Sample\n\nOne row of the dataset looks like this:\n\n```python\n{'PuzzleId': '000hf',\n 'GameId': '71ygsFeE/black#38',\n 'FEN': 'r1bqk2r/pp1nbNp1/2p1p2p/8/2BP4/1PN3P1/P3QP1P/3R1RK1 b kq - 0 19',\n 'Moves': 'e8f7 e2e6 f7f8 e6f7',\n 'Rating': 1575,\n 'RatingDeviation': 75,\n 'Popularity': 92,\n 'NbPlays': 674,\n 'Themes': ['mate', 'mateIn2', 'middlegame', 'short'],\n 'OpeningTags': ['Horwitz_Defense', 'Horwitz_Defense_Other_variations']}\n```\n### Dataset Fields\n\nEvery row of the dataset contains the following fields:\n\n- **`PuzzleId`**: `string`, the puzzle's unique identifier. The puzzle would be live at `https://lichess.org/training/{PuzzleID}`.\n- **`GameId`**: `string`, the unique identifier of the specific game and move the puzzle was extracted from. The game would be accessible at `https://lichess.org/{GameId}`\n- **`FEN`**: `string`, the FEN string of the position before the opponent makes their move.\n- **`Moves`**: `string`, the solution to the puzzle. All player moves of the solution are \"only moves\", i.e. playing any other move would considerably worsen the player position. An exception is made for mates in one: there can be several. Any move that checkmates should win the puzzle.\n- **`Rating`**: `int`, the Glicko-2 rating of the puzzle.\n- **`RatingDeviation`**: `int`, the Glicko-2 rating deviation of the puzzle.\n- **`Popularity`**: `int`, a number between `100` (best) and `-100` (worst), calculated as `100 * (upvotes - downvotes)/(upvotes + downvotes)`. Votes are weighted by various factors such as whether the puzzle was solved successfully or the solver's puzzle rating in comparison to the puzzle's.\n- **`NbPlays`**: `int`, the number of times a puzzle was played.\n- **`Themes`**: `list`, a list of puzzle themes.\n- **`OpeningTags`**: `list`, a list of openings. This is only set for puzzles starting before move 20.\n\n## Additional Information\n- For a list of all possible puzzle themes and their description: [puzzleTheme.xml](https://github.com/ornicar/lila/blob/master/translation/source/puzzleTheme.xml)\n- To better understand puzzle themes, check out this study: https://lichess.org/study/viiWlKjv\n- GitHub Repo: https://github.com/lichess-org/database\n- Official Website: https://database.lichess.org/#puzzles\n- For a list of all possible openings: https://github.com/l","encoding":"utf8","key":"README.md","name":"README.md","size":4426,"truncated":true}],"sourceObjectKey":"data/train-00000-of-00003.parquet","starterCell":"from datasets import load_dataset\nds = load_dataset(\"Lichess/chess-puzzles\")\nprint(ds)","starterSamplePath":"data/train-00000-of-00003.parquet","totalObjects":5},"summary":"Tactical chess puzzles generated from real Lichess games, rated and tagged by theme. The card reports 6,157,341 puzzles, updated monthly.","title":"Lichess Chess Puzzles Database","updatedAt":"2026-11-14T17:45:56.834Z","visibility":"public","websiteUrl":"https://database.lichess.org/#puzzles"}}