PGN Files - official-stockfish/fishtest GitHub Wiki

PGN Files of Games Played on Fishtest

This page explains how to access and download PGN files of chess games played on Fishtest.

Downloading PGNs Directly from Fishtest

There are several ways to download PGNs for recent tests directly from the Fishtest interface or API:

Important

  • STC tests are available for 1 day.
  • LTC tests are available for 10 days.
  • Tuning Tests: Games from tuning tests are generally NOT stored or made available for download.
  • Task Completion: PGN files for a specific task only become available after the worker running that task has completed it and reported back.
  • Availability Errors: If you attempt to download a PGN file that does not exist (either because the test/task is not complete, the PGN has expired, or the ID is incorrect), you will typically receive a 404 Not Found error.
  • Individual Task PGNs:
    • Navigate to the specific test page.
    • In the task overview table, click the link in the Idx column for the desired task.
    • This downloads a PGN file containing only the games for that specific task.
  • Full Test PGNs (Web Interface):
    • Navigate to the specific test page.
    • Click the Download games button in the "Actions" panel (usually on the right).
    • This provides a compressed PGN file (.pgn.gz) containing all the available games for the test.
  • Full Test PGNs (API):
    • Use the run_pgns API endpoint: 
      https://tests.stockfishchess.org/api/run_pgns/<test-Id>.pgn.gz
    • Replace <test-Id> with the unique ID (SHA) of the test.
    • This provides a compressed PGN file (.pgn.gz) containing all the available games for the test.
  • Bulk Downloading (Script):

Long-Term Archive (Hugging Face)

For accessing older games from LTC tests, a long-term archive is maintained:

  • Source: https://huggingface.co/datasets/robertnurnberg/fishtest_pgns
  • Content: Strict LTC games, that is at least 40 seconds base time control for each side. The oldest available PGNs are from May 2018, whilst from September 2023 onwards the archive is nearly complete.
  • Direct Download URL Structure: 
    https://huggingface.co/datasets/robertnurnberg/fishtest_pgns/resolve/main/YY-MM-DD/<test-Id>/<test-Id>.pgn.gz
    • Replace YY-MM-DD with the date the test started (e.g., 23-10-26). This date is listed under start time on the individual test page on Fishtest.
    • Replace <test-Id> with the unique ID (SHA) of the test. (twice)

Legacy Archives

The Hugging Face repository also incorporates the legacy PGN archives previously curated by Tom Vijlbrief. These were originally hosted on Google Drive:

Note: While these two links are provided for historical context, the recommended source for archived LTC games is the Hugging Face repository mentioned above.

Fishtest

⚠️ **GitHub.com Fallback** ⚠️