Local Machine Software
Sorter
The Sorter V2 local software — the Python backend that drives the hardware and the SvelteKit UI that operates it. Install it, operate it, and read how it works under the hood.
Install
- Installation — SorterOS image for Orange Pi 5, one-command installer for generic Linux, or manual setup.
- Install by hand — the manual sequence, for when the installer does not yet support your platform.
Operate
- Your first sort run — the end-to-end happy path: pick a profile, feed the machine, check a bin, stop cleanly.
- Camera calibration — focus with a Siemens Star, then auto-calibrate color with a SpyderCheckr 24.
- Sorter troubleshooting — symptom-led entries for install, first-run, and runtime problems.
Under the hood
- Dev flow — the dev backend and UI services, how to enable them, and the difference between a soft restart and a full restart.
- Sorting profile reference — the on-disk shape of
sorting_profile.json— rules, conditions,part_to_category, set inventories. Accurate forschema_version: 1. - machine.toml reference — every field in the machine-specific config file: servo, chute, carousel, stepper bindings and overrides, cameras, and GPIO LEDs. This lives in the docs site, not the Sorter UI.
Coming soon
These flows do not yet have dedicated pages:
- Setup wizard — the first-boot flow: cameras, lighting, homing, chamber zones, servos, Hive link.
- Operating the UI at scale — running long sessions, reviewing classification samples, tuning vision, checking runtime health.
Until those land, the authoritative sources are software/README.md, software/sorter/backend/coordinator.py, and the in-app /styleguide route which renders the live component set.