Sorter V2
Sorter V2 Documentation
The durable documentation layer for the Sorter V2 project — hardware, the local machine software, the Hive community platform, and the lab where research and contributor references live.
Start here
New to the project? Prerequisites, contribution tracks, key resources, and how the project works.
The physical machine — mechanics, electronics, bill of materials, and assembly notes.
The local software running on the machine — Python backend, SvelteKit UI, setup wizard, profiles.
The community platform — shared sorting profiles, uploaded samples, crowd verification.
Research and contributor references — detector runtime findings, model artifacts, benchmarks, and the shared styleguide.
What’s stable and what’s a stub
Right now the site is uneven on purpose:
- Lab is the only section with real, promoted content — the April 6, 2026 detector findings plus the shared styleguide that keeps the Sorter UI, Hive, and this site visually consistent.
- Hardware, Sorter, and Hive are still placeholder indexes. Their content is being promoted out of code comments, in-repo notes, and the handoff file as each area stabilizes.
The durable rule: keep decisions and workflows in checked-in Markdown here, and treat every generated report or experiment bundle under software/sorter/backend/blob/ as disposable working state unless a document in this site promotes it.
Editing and publishing
The site source lives in docs/ and is deployed via GitHub Pages. To preview locally, run:
./docs/local-jekyll.sh serve
and open http://localhost:4000. Live-reload picks up Markdown changes automatically.