lichess.org open database

132,053,332 chess positions evaluated with Stockfish.
Produced by, and for, the Lichess analysis board, running various flavours of Stockfish within user browsers.

Download lichess_db_eval.jsonl.zst

This file was last updated on 01/12/2024.

Format

Evaluations are formatted as JSON; one position per line.

The schema of a position looks like this:

{
  "fen":          // the position FEN only contains pieces, active color, castling rights, and en passant square.
  "evals": [      // a list of evaluations, ordered by number of PVs.
      "knodes":   // number of kilo-nodes searched by the engine
      "depth":    // depth reached by the engine
      "pvs": [    // list of principal variations
        "cp":     // centipawn evaluation. Omitted if mate is certain.
        "mate":   // mate evaluation. Omitted if mate is not certain.
        "line":   // principal variation, in UCI format.
}

Each position can have multiple evaluations, each with a different number of PVs.

Sample

{
  "fen": "2bq1rk1/pr3ppn/1p2p3/7P/2pP1B1P/2P5/PPQ2PB1/R3R1K1 w - -",
  "evals": [
    {
      "pvs": [
        {
          "cp": 311,
          "line": "g2e4 f7f5 e4b7 c8b7 f2f3 b7f3 e1e6 d8h4 c2h2 h4g4"
        }
      ],
      "knodes": 206765,
      "depth": 36
    },
    {
      "pvs": [
        {
          "cp": 292,
          "line": "g2e4 f7f5 e4b7 c8b7 f2f3 b7f3 e1e6 d8h4 c2h2 h4g4"
        },
        {
          "cp": 277,
          "line": "f4g3 f7f5 e1e5 d8f6 a1e1 b7f7 g2c6 f8d8 d4d5 e6d5"
        }
      ],
      "knodes": 92958,
      "depth": 34
    },
    {
      "pvs": [
        {
          "cp": 190,
          "line": "h5h6 d8h4 h6g7 f8d8 f4g3 h4g4 c2e4 g4e4 g2e4 g8g7"
        },
        {
          "cp": 186,
          "line": "g2e4 f7f5 e4b7 c8b7 f2f3 b7f3 e1e6 d8h4 c2h2 h4g4"
        },
        {
          "cp": 176,
          "line": "f4g3 f7f5 e1e5 f5f4 g2e4 h7f6 e4b7 c8b7 g3f4 f6g4"
        }
      ],
      "knodes": 162122,
      "depth": 31
    }
  ]
}

Notes

Evaluations have various depths and node count. If you only want one PV, we recommend selecting the evaluation with the highest depth, and use its first PV.

4,407,884 chess puzzles, rated, and tagged. See them in action on Lichess.

Download lichess_db_puzzle.csv.zst

This file was last updated on 01/12/2024.

Format

Puzzles are formatted as standard CSV. The fields are as follows:

PuzzleId,FEN,Moves,Rating,RatingDeviation,Popularity,NbPlays,Themes,GameUrl,OpeningTags

Sample

00sHx,q3k1nr/1pp1nQpp/3p4/1P2p3/4P3/B1PP1b2/B5PP/5K2 b k - 0 17,e8d7 a2e6 d7d8 f7f8,1760,80,83,72,mate mateIn2 middlegame short,https://lichess.org/yyznGmXs/black#34,Italian_Game Italian_Game_Classical_Variation
00sJ9,r3r1k1/p4ppp/2p2n2/1p6/3P1qb1/2NQR3/PPB2PP1/R1B3K1 w - - 5 18,e3g3 e8e1 g1h2 e1c1 a1c1 f4h6 h2g1 h6c1,2671,105,87,325,advantage attraction fork middlegame sacrifice veryLong,https://lichess.org/gyFeQsOE#35,French_Defense French_Defense_Exchange_Variation
00sJb,Q1b2r1k/p2np2p/5bp1/q7/5P2/4B3/PPP3PP/2KR1B1R w - - 1 17,d1d7 a5e1 d7d1 e1e3 c1b1 e3b6,2235,76,97,64,advantage fork long,https://lichess.org/kiuvTFoE#33,Sicilian_Defense Sicilian_Defense_Dragon_Variation
00sO1,1k1r4/pp3pp1/2p1p3/4b3/P3n1P1/8/KPP2PN1/3rBR1R b - - 2 31,b8c7 e1a5 b7b6 f1d1,998,85,94,293,advantage discoveredAttack master middlegame short,https://lichess.org/vsfFkG0s/black#62,

Notes

Moves are in UCI format. Use a chess library to convert them to SAN, for display.

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.

FEN is the position before the opponent makes their move.
The position to present to the player is after applying the first move to that FEN.
The second move is the beginning of the solution.

Popularity is a number between 100 (best) and -100 (worst).
It is calculated as 100 * (upvotes - downvotes)/(upvotes + downvotes), although votes are weigthed by various factors such as whether the puzzle was solved successfully or the solver's puzzle rating in comparison to the puzzle's.

You can find a list of themes, their names and descriptions, in this file.

The OpeningTags field is only set for puzzles starting before move 20. Here's the list of possible openings.

Generating these chess puzzles took more than 50 years of CPU time.
We went through 300,000,000 analysed 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. To determine the rating, each attempt to solve is considered as a Glicko2 rated game between the player and the puzzle. Finally, player votes refine the tags and define popularity.

Antichess

29,436,895 antichess rated games, played on lichess.org, in PGN format. Each file contains the games for one month only; they are not cumulative.

Here's a plain text download list, and the SHA256 checksums.

Atomic

22,769,011 atomic rated games, played on lichess.org, in PGN format. Each file contains the games for one month only; they are not cumulative.

Here's a plain text download list, and the SHA256 checksums.

Chess960

21,456,037 chess960 rated games, played on lichess.org, in PGN format. Each file contains the games for one month only; they are not cumulative.

Here's a plain text download list, and the SHA256 checksums.

Crazyhouse

24,361,984 crazyhouse rated games, played on lichess.org, in PGN format. Each file contains the games for one month only; they are not cumulative.

Here's a plain text download list, and the SHA256 checksums.

Horde

5,775,774 horde rated games, played on lichess.org, in PGN format. Each file contains the games for one month only; they are not cumulative.

Here's a plain text download list, and the SHA256 checksums.

King of the Hill

6,676,967 kingOfTheHill rated games, played on lichess.org, in PGN format. Each file contains the games for one month only; they are not cumulative.

Here's a plain text download list, and the SHA256 checksums.

Racing Kings

5,148,315 racingKings rated games, played on lichess.org, in PGN format. Each file contains the games for one month only; they are not cumulative.

Here's a plain text download list, and the SHA256 checksums.

Three-check

8,392,863 threeCheck rated games, played on lichess.org, in PGN format. Each file contains the games for one month only; they are not cumulative.

Here's a plain text download list, and the SHA256 checksums.