https://github.com/lichess-org/chess-openings

An aggregated data set of chess opening names
https://github.com/lichess-org/chess-openings

chess dataset lichess

Last synced: 1 day ago
JSON representation

An aggregated data set of chess opening names

• Host: GitHub
• URL: https://github.com/lichess-org/chess-openings
• Owner: lichess-org
• License: cc0-1.0
• Created: 2016-02-25T11:04:56.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2024-12-14T10:59:33.000Z (17 days ago)
• Last Synced: 2024-12-23T00:02:21.097Z (8 days ago)
• Topics: chess, dataset, lichess
• Language: Python
• Homepage:
• Size: 1.72 MB
• Stars: 385
• Watchers: 17
• Forks: 95
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: COPYING.txt

Awesome Lists containing this project

README

        
Chess opening names

===================

An aggregated data set of chess opening names.

field | `/` | `dist/` | description

--- | --- | --- | ---

eco | x | x | [ECO](https://en.wikipedia.org/wiki/Encyclopaedia_of_Chess_Openings) classification

name | x | x | Opening name (English language)

pgn | x | x| Well known sequence of moves, or the most common moves to reach the opening position based on master games, as PGN

uci | | x | Same moves as `pgn` in [UCI notation](https://backscattering.de/chess/uci/#move)

epd | | x | [EPD](https://www.chessprogramming.org/Extended_Position_Description) (FEN without move numbers) of the opening position, en passant field only if legal

To generate `dist/`, install Python, then `pip3 install chess` and run `make`.

Or select the latest

[workflow run](https://github.com/lichess-org/chess-openings/actions) and

download build artifacts.

This dataset is also [available in the Apache Parquet format](https://hf.co/datasets/Lichess/chess-openings).

Conventions

-----------

* Title case is used for opening names.

* Names are structured like `Opening family: Variation, Subvariation, ...`,

  e.g., `Sicilian Defense: Najdorf Variation, English Attack`.

* The suggested way to classify games is to play moves backwards until

  a named position is found. To make this work well with common transpositions,

  multiple entries for a single opening may be added.

* However, each name has a unique *shortest* line. If necessary,

  a distinguishing move is appended, e.g.,

  `King's Gambit Accepted: Schurig Gambit, with Bb5`.

Contributing

------------

Opening data is in `a.tsv`, `b.tsv`, `c.tsv`, `d.tsv`, and `e.tsv`.

Improvements, additions and fixes are welcome. If you have concrete

suggestions, please be bold and submit the proposed changes directly as pull

requests!

The changes will be live on lichess.org after the next update of

[scalachess](https://github.com/lichess-org/scalachess) (no fixed schedule)

and the

[opening explorer](https://github.com/lichess-org/lila-openingexplorer)

(daily).

Copyright

---------

As a collection of facts, this data set is in the public domain.

Considerable effort was spent curating and cleaning the data. Insofar as that

qualifies for copyright, the work is released under the

CC0 Public Domain Dedication.

[![CC0](https://i.creativecommons.org/p/zero/1.0/88x31.png)](https://creativecommons.org/publicdomain/zero/1.0/)