Reproducing Without Re-crawling

Collaborators can skip the 8–10 hour crawl entirely. The dataset is already on HuggingFace; choose how deeply you want to work with it.

Step 1 — Clone and install

git clone https://github.com/sysec-uic/syzfix.git
cd syzfix
python3 -m venv venv
source venv/bin/activate        # Windows: venv\Scripts\activate
pip install -r requirements.txt

All commands below are run from the project root (syzfix/).

Step 2 — Restore full processed data (~2 GB download)

# Download and unpack the full per-bug JSON files
python -m dataset.restore_processed --repo xiaoguangwang/syzfix-dataset

restore_processed streams the file line-by-line — constant RAM usage.

Once restored, you can browse individual bugs with the interactive viewer — see exploring.md.

Updating the dataset with new syzbot bugs

If you maintain the dataset and want to add bugs that syzbot has fixed since the last crawl, see collection.md → Adding new bugs from syzbot for the incremental crawl + rebuild checklist.