mrmlengineer/chess_games

Chess Games Dataset

This dataset is a compact, ML-oriented chess game dataset generated from `angeluriot/chess_games` plus additional 2025 games extracted from Lumbras Giga Base.

It keeps only the move sequence in UCI notation, a derived minimum Elo field, and a source label. This makes the dataset smaller and simpler to consume than the base dataset when the downstream task only needs legal move sequences and a coarse player-strength signal.

Dataset Summary

• —Games: 15,272,234
• —Files: 8 Parquet shards
• —Compressed size: 2.48 GiB
• —Split: train
• —Format: Parquet

Data Sources

The base dataset is `angeluriot/chess_games`, which already includes games from multiple public chess sources.

The added 2025 games come from Lumbras Giga Base, using the 2025 OTB and Online PGN files. Special thanks to Lumbras Giga Base for collecting and curating the chess game sources used by the base dataset and this extension.

Dataset Structure

Each row represents one chess game.

Rows with null min_elo: 2,053,362.

Differences From angeluriot/chess_games

This dataset is not a full mirror of the base dataset. It intentionally removes metadata that is not needed for the target training workflows.

Removed fields:

• —date
• —white_elo
• —black_elo
• —end_type
• —winner
• —moves_san
• —moves_custom

Added or changed fields:

• —min_elo is derived from white_elo and black_elo.
• —source preserves the original base-dataset source label when available.
• —2025 Lumbras Giga Base OTB and Online PGN games are appended.
• —Rows are sorted by descending min_elo, with null values last.

Usage

Hugging Face Datasets

from datasets import load_dataset

dataset = load_dataset("mrmlengineer/chess_games")

game = dataset["train"][0]
print(game["moves_uci"])
print(game["min_elo"])
print(game["source"])

Streaming

from datasets import load_dataset

dataset = load_dataset(
    "mrmlengineer/chess_games",
    streaming=True,
)

for game in dataset["train"]:
    print(game["moves_uci"])
    break

License

This combined dataset is released under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International because Lumbras Giga Base states that its work is licensed under CC BY-NC-SA 4.0. The base dataset angeluriot/chess_games is distributed on Hugging Face with an MIT license.

Users should respect the terms of both upstream sources.

Limitations

• —The dataset has a single train split; no validation or test split is provided.
• —min_elo is null when either player Elo is unavailable.
• —Only the mainline UCI move sequence is included.
• —Commercial use is restricted by the CC BY-NC-SA 4.0 license.