scyros 0.3.1

A framework to design sound, reproducible and scalable mining repositories studies on GitHub.
docs.rs failed to build scyros-0.3.1
Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.
Visit the last successful build: scyros-0.2.4

Scyros

Actions status License Rust Crates.io

A framework to design sound, reproducible and scalable mining repositories studies on GitHub.

Scyros is...

  • 🧪 Reproducibility-first: declarative configuration and deterministic execution to enable repeatable experiments.
  • 📈 Scalable: designed for large-scale repository mining studies on GitHub.
  • 🧱 Soundness-focused: encourages transparent, bias-aware, and methodologically explicit study design.
  • ⚙️ Modular: independent, reusable modules that can be composed into custom data-processing pipelines.

Table of Contents

Installation

Prebuilt binaries

Prebuilt binaries for macOS, Linux, and Windows are available on the project's GitHub Releases page, along with installer scripts.

Using a package manager

Scyros is available through several package managers.

Cargo

Scyros is published on crates.io and can be installed with Cargo:

cargo install scyros

Nix

If you use Nix with flakes enabled, you can install Scyros directly from GitHub:

nix profile install github:fxpl/scyros

Build from source

Install Rust (version 1.94 or newer) by following the instructions on the official website.

Then clone the repository and build:

git clone git@github.com:fxpl/scyros.git
cd scyros
cargo build --release

The binary is produced at target/release/scyros. You can optionally move it to a directory in your PATH for easier access.

Tutorial

If you'd like to see how to use Scyros in practice, check out the interactive tutorial!

Usage

To discover available commands and modules:

scyros --help

Each module provides its own usage documentation. For example, to inspect the module used to sample random repositories from GitHub:

scyros ids --help

Authentication and Rate Limits

Some modules interact with the GitHub API and require personal access tokens (PATs). Tokens can be created by following GitHub’s documentation: https://docs.github.com/en/github/authenticating-to-github/creating-a-personal-access-token.

⚠️ Never commit or share your tokens publicly.

Tokens must be provided as a CSV file passed via a command-line argument. The file must contain a single column named token, with one token per line:

    token
    fa56454....
    hj73647....

GitHub enforces API rate limits. Using multiple tokens from the same account does not increase these limits. Users are expected to comply with GitHub’s API terms and rate-limit policies:

Citing Scyros

Scyros is introduced and described in the following large-scale empirical study. If you use Scyros in academic work, please cite:

@article{gilot2026largescalestudyfloatingpointusage,
author = {Gilot, Andrea and Wrigstad, Tobias and Darulova, Eva},
title = {Floating-Point Usage on GitHub: A Large-Scale Study of Statically Typed Languages},
year = {2026},
issue_date = {April 2026},
publisher = {Association for Computing Machinery},
address = {New York, NY, USA},
volume = {10},
number = {OOPSLA1},
url = {https://doi.org/10.1145/3798203},
doi = {10.1145/3798203},
journal = {Proc. ACM Program. Lang.},
month = apr,
articleno = {95},
numpages = {28},
keywords = {floating-point arithmetic, large-scale code analysis, repository mining}
}

Andrea Gilot, Tobias Wrigstad, and Eva Darulova. 2026. Floating-Point Usage on GitHub: A Large-Scale Study of Statically Typed Languages. Proc. ACM Program. Lang. 10, OOPSLA1, Article 95 (April 2026), 28 pages. https://doi.org/10.1145/3798203

License

This project is licensed under the Apache License 2.0. See LICENSE for details.

Change Log

See CHANGELOG.md for a detailed list of changes and updates.