{"success":true,"data":{"author":"Lichess (lichess.org)","bucketAccessType":"public","bucketName":"Lichess/chess-position-evaluations","bucketPrefix":"","category":"Machine Learning & AI","cloudProvider":"huggingface","createdAt":"2026-11-14T14:15:20.045Z","description":"Chess positions evaluated with the Stockfish engine, produced by and for the Lichess analysis board, where various builds of Stockfish run inside users' browsers. The card reports 416,442,401 positions and monthly updates. Each row gives a position as a FEN string, the principal variation as a sequence of UCI moves, the search depth, the number of kilonodes searched and the score either as centipawns (cp) or as a forced mate distance (mate); a position can appear several times with different depths and lines. Listing data/ (measured 2026-11-14) shows 20 Parquet shards of about 2.2 GB each, and the repository uses about 609 GB. The data serve as supervised targets for training neural chess evaluation functions and value networks, for distillation of engine knowledge into small models, for benchmarking evaluation accuracy and for studying position complexity. Load it with Hugging Face datasets (load_dataset with split train, or streaming=True), pyarrow, polars or DuckDB, and parse positions with python-chess. Lichess releases its database exports under CC0.","displayTitle":"Lichess Chess Position Evaluations (Stockfish)","id":"c44aead3-fb91-53ae-bf97-829ff4261a88","license":"CC0-1.0","licenseEvidenceUrl":"https://database.lichess.org/","objectCountEstimate":22,"probeStatus":"ok","region":"us","schemaCard":{"accessHints":[{"language":"python-datasets","snippet":"from datasets import load_dataset\nds = load_dataset(\"Lichess/chess-position-evaluations\")"},{"language":"python-hub","snippet":"from huggingface_hub import snapshot_download\nsnapshot_download(repo_id=\"Lichess/chess-position-evaluations\", repo_type=\"dataset\")"}],"caveats":["HuggingFace metadata: author=Lichess, license:cc0-1.0, size_categories:1B<n<10B, format:parquet, downloads=8593"],"format":"mixed","generatedAt":"2026-11-14T14:15:24.271Z","layout":{"example":"data/data_0000.parquet","pattern":"{repoId}/{filename}"},"mountPath":"/mnt/archive","sampleHeaders":[{"bytes":"50415231150415a2938001159696374c15d8af021500120000d18940f05e2c00000037722f3170336b322f7031625052332f3570322f3242325031702f382f50503450312f334b342062202d202d25000000382f3472332f325232706b312f3670702f3350342f3650312f354b31502f382062202d202d1e000000366b012034312f382f344b332f344e4e322f380102f0402077202d202d3c00000072316232726b312f317032627070702f70316e70706e322f71372f32503150332f4e314e352f505032425050502f5231425131524b31200540082000000562043452013a0559242f382f355050502f364b0d24001f0d24183670312f364e310d880033092e09a900340187206e62716b626e722f700d01092105ff0901402f524e42514b424e522077204b516b7120055b01220c324e326b01d82c31703270332f70372f4b372f0d5b0025252d083172366a2d0105cb34370000003152346b312f3371317001ac886e312f6232703250702f3270503262312f703150352f50314251725050422f354e4b3109bf21680c382f356b013542e100055d003a015d486b31723172322f7062703370702f317031713121e660703251322f3450332f3150315042332f5031503350502f34523566002605c4303342342f382f703470316b2f354119145062362f3150411b356c003e21492432716b32722f336e327021d5b87031","encoding":"hex","key":"data/data_0000.parquet","truncatedAt":512}],"sampleObjects":["data/data_0000.parquet","data/data_0001.parquet","data/data_0002.parquet","data/data_0003.parquet","data/data_0004.parquet"],"sidecars":[{"bytes":"---\nlicense: cc0-1.0\nsize_categories:\n- 100M<n<1B\nconfigs:\n- config_name: default\n  data_files:\n  - split: train\n    path: data/data_*\ntags:\n- chess\n- stockfish\n- lichess\n- games\n---\n# Dataset Card for the Lichess Evaluations dataset\n\n<!-- Provide a quick summary of the dataset. -->\n## Dataset Description\n\n**416,442,401 chess positions** evaluated with Stockfish at various depths and node count. Produced by, and for, the [Lichess analysis board](https://lichess.org/analysis), running various flavours of Stockfish within user browsers. This version of the dataset is a de-normalized version of [the original dataset](https://database.lichess.org/#evals) and contains **1,003,347,246 rows**.\n\nThis dataset is updated monthly, and was last updated on October 7th, 2026.\n\n### Dataset Usage\n\nUsing the `datasets` library:\n\n```python\nfrom datasets import load_dataset\ndset = load_dataset(\"Lichess/chess-evaluations\", split=\"train\")\n```\n\n## Dataset Details\n\n### Dataset Sample\n\nOne row of the dataset looks like this:\n\n```python\n{\n  \"fen\": \"2bq1rk1/pr3ppn/1p2p3/7P/2pP1B1P/2P5/PPQ2PB1/R3R1K1 w - -\",\n  \"line\": \"g2e4 f7f5 e4b7 c8b7 f2f3 b7f3 e1e6 d8h4 c2h2 h4g4\",\n  \"depth\": 36,\n  \"knodes\": 206765,\n  \"cp\": 311,\n  \"mate\": None\n}\n```\n\n### Dataset Fields\n\nEvery row of the dataset contains the following fields:\n\n- **`fen`**: `string`, the position FEN only contains pieces, active color, castling rights, and en passant square.\n- **`line`**: `string`, the principal variation, in UCI format.\n- **`depth`**: `string`, the depth reached by the engine.\n- **`knodes`**: `int`, the number of kilo-nodes searched by the engine.\n- **`cp`**: `int`, the position's centipawn evaluation. This is `None` if mate is certain.\n- **`mate`**: `int`, the position's mate evaluation. This is `None` if mate is not certain.","encoding":"utf8","key":"README.md","name":"README.md","size":1801,"truncated":false}],"sourceObjectKey":"data/data_0000.parquet","starterCell":"from datasets import load_dataset\nds = load_dataset(\"Lichess/chess-position-evaluations\")\nprint(ds)","starterSamplePath":"data/data_0000.parquet","totalObjects":22},"summary":"Chess positions evaluated with the Stockfish engine, produced by and for the Lichess analysis board, where various builds of Stockfish run inside users' browsers.","title":"Lichess Chess Position Evaluations (Stockfish)","updatedAt":"2026-11-14T17:29:50.903Z","visibility":"public","websiteUrl":"https://database.lichess.org/#evals"}}