# Lichess Chess Position Evaluations (Stockfish)

## Facts

- Provider: Lichess (lichess.org)
- License: CC0-1.0 (https://database.lichess.org/)
- Size: 22 files
- Format: Parquet (in sampled files)
- Stored at: Hugging Face, https://huggingface.co/datasets/Lichess/chess-position-evaluations
- Access: public, readable without an account
- Category: Machine Learning & AI
- Source: https://database.lichess.org/#evals
- Page: https://scigantic.com/archive/c44aead3-fb91-53ae-bf97-829ff4261a88
- Keywords: Machine Learning & AI, Parquet, Hugging Face

## About

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.

## Load the data

```python
from datasets import load_dataset
ds = load_dataset("Lichess/chess-position-evaluations")
print(ds)
```

## Data structure

File types in sampled files: Parquet

Example file: `data/data_0000.parquet`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/c44aead3-fb91-53ae-bf97-829ff4261a88
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/c44aead3-fb91-53ae-bf97-829ff4261a88
- Over MCP: `get_schema_card` with id `c44aead3-fb91-53ae-bf97-829ff4261a88` at https://api.scigantic.com/mcp

## Related topics

- [Parquet datasets](https://scigantic.com/topics/parquet)
- [Machine Learning & AI datasets](https://scigantic.com/topics/machine-learning-and-ai)
