You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Sep 18, 2026. It is now read-only.
Reproducibility is one of Spindle's most useful properties — same seed, same output, every time — but the --seed flag in the CLI only has a one-line help string, and the README doesn't show a "generate the same data twice" example.
What to do
Expand the --seed help text in cli/main.py (or wherever it lives) to mention:
Default behavior when not provided
That the seed propagates through all generators in the run
That the same seed produces identical output (assuming same version)
Add a 6–8 line "Reproducibility" section to README.md under Quick Start with a worked example showing two runs of the same --seed producing identical row counts and the same hash of the first 100 rows
Optional: link to a tutorial page if you want to expand further
Why this is a good first issue
Touches only docs + a help string — no engine changes
Reproducibility is one of Spindle's most useful properties — same seed, same output, every time — but the
--seedflag in the CLI only has a one-line help string, and the README doesn't show a "generate the same data twice" example.What to do
--seedhelp text incli/main.py(or wherever it lives) to mention:README.mdunder Quick Start with a worked example showing two runs of the same--seedproducing identical row counts and the same hash of the first 100 rowsWhy this is a good first issue
Feel free to suggest wording in a draft PR.