Datasets based on the 2024-08-23 export

Referencing Software Heritage

If you use any of the datasets indexed on this website for research purposes, please acknowledge Software Heritage as recommended in the publications page, that is:

1. Add a footnote on the title page of your paper, formatted as: “This work was made possible by Software Heritage, the universal source code archive: https://www.softwareheritage.org”; and
2. cite at least one of the following papers:
   • Roberto Di Cosmo, Stefano Zacchiroli. Software Heritage: Why and How to Preserve Software Source Code. iPRES 2017. (BibTeX)
   • Jean-François Abramatic, Roberto Di Cosmo, Stefano Zacchiroli. Building the universal archive of source code. Commun. ACM 61(10): 29-31 (2018). (BibTeX)

Specific datasets might recommend additional citations, to credit their creators.

5 datasets

• Compressed graph #

  Comments

  This graph changed the MPH from GOV/Cmph to PTHash; Rust code hardcoding GOVMPH needs to replace it with DynMph or SwhidPthash. Java is no longer supported to read this graph.

  Dataset size

  11 TiB

  Export date

  2024-08-23

  Teaser dataset

  Popular 500 python compressed graph (15 GB)

  Popular 500 python provenance (all releases and revisions) (46 GB)

  S3 URL

  s3://softwareheritage/graph/2024-08-23/compressed/

  Specific citation instructions

  If you use this dataset for research purposes, please cite the following paper: Antoine Pietri, Diomidis Spinellis, Stefano Zacchiroli. The Software Heritage Graph Dataset: Public software development under one roof. In proceedings of MSR 2019: The 16th International Conference on Mining Software Repositories, May 2019, Montreal, Canada. Co-located with ICSE 2019 (Preprint), (BibTeX).

  Download

  For Amazon S3 links, you'll need to install either awscli or swh.datasets.

  aws s3 cp --recursive --no-sign-request s3://softwareheritage/graph/2024-08-23/compressed/ 2024-08-23-compressed
  # OR
  swh datasets download-graph 2024-08-23

• Graph export in columnar tables #

  Dataset size

  19 TiB

  Export date

  2024-08-23

  Teaser dataset

  Popular 500 python columnar tables (36 GB)

  S3 URL

  s3://softwareheritage/graph/2024-08-23/orc/

  Download

  For Amazon S3 links, you'll need to install either awscli or swh.datasets.

  aws s3 cp --recursive --no-sign-request s3://softwareheritage/graph/2024-08-23/orc/ 2024-08-23-orc
  # OR
  swh datasets download-export 2024-08-23

• Popular 500 python columnar tables #

  Comments

  This teaser contains a subset of the 443 repositories archived by Software Heritage as of 2024-08-23, among the 700 GitHub repositories tagged as being written in Python with the most stars.

  Dataset size

  36 GB

  Export date

  2024-08-23

  Teaser of

  Graph export in columnar tables [2024-08-23]

  S3 URL

  s3://softwareheritage/graph/2024-08-23-popular-500-python/orc/

  Download

  For Amazon S3 links, you'll need to install either awscli or swh.datasets.

  aws s3 cp --recursive --no-sign-request s3://softwareheritage/graph/2024-08-23-popular-500-python/orc/ 2024-08-23-popular-500-python-orc
  # OR
  swh datasets download-export 2024-08-23-popular-500-python

• Popular 500 python compressed graph #

  Comments

  This teaser contains a subset of the 443 repositories archived by Software Heritage as of 2024-08-23, among the 700 GitHub repositories tagged as being written in Python with the most stars.

  Dataset size

  15 GB

  Export date

  2024-08-23

  Teaser of

  Compressed graph [2024-08-23]

  S3 URL

  s3://softwareheritage/graph/2024-08-23-popular-500-python/compressed/

  Specific citation instructions

  If you use this dataset for research purposes, please cite the following paper: Antoine Pietri, Diomidis Spinellis, Stefano Zacchiroli. The Software Heritage Graph Dataset: Public software development under one roof. In proceedings of MSR 2019: The 16th International Conference on Mining Software Repositories, May 2019, Montreal, Canada. Co-located with ICSE 2019 (Preprint), (BibTeX).

  Download

  For Amazon S3 links, you'll need to install either awscli or swh.datasets.

  aws s3 cp --recursive --no-sign-request s3://softwareheritage/graph/2024-08-23-popular-500-python/compressed/ 2024-08-23-popular-500-python-compressed
  # OR
  swh datasets download-graph 2024-08-23-popular-500-python

• Popular 500 python provenance (all releases and revisions) #

  Comments

  This teaser contains a subset of the 443 repositories archived by Software Heritage as of 2024-08-23, among the 700 GitHub repositories tagged as being written in Python with the most stars.

  Dataset size

  46 GB

  Export date

  2024-08-23

  Teaser of

  Compressed graph [2024-08-23]

  S3 URL

  s3://softwareheritage/graph/2024-08-23-popular-500-python/provenance/all/

  Download

  For Amazon S3 links, you'll need to install either awscli or swh.datasets.

  aws s3 cp --recursive --no-sign-request s3://softwareheritage/graph/2024-08-23-popular-500-python/provenance/all/ 2024-08-23-popular-500-python-provenance_all

By accessing the datasets, you agree with the Software Heritage Ethical Charter for using the archive data, the terms of use for bulk access, and the Software Heritage principles for large language models.

To learn how to use the datasets read the documentation.