Sorter V2 Documentation

⚠ Under heavy construction

As of July 11, 2026, Sorter V2 is not yet in a position to be built.

The documentation that exists is incomplete. Any given page may be accurate, inaccurate, present only as an example, or badly out of date. We do not yet recommend that anyone attempt to build Sorter.

For the most live updates on our progress, join our Discord ↗.

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 for schema_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.