docs(tutorials): Pi 5 + Hailo cluster rvcsi tutorial#546
Merged
Conversation
Field-tested walkthrough for building a 4-node Raspberry Pi 5 + 2×
Hailo-8 multistatic Wi-Fi CSI cognitive RF observer using rvcsi. Built
against the v0-appliance v0.5.0-cognitive-rf-observer milestone — 446k+
observed fingerprints, 16 stable RF states, 2nd-order Markov running at
39% top-1 ceiling (1.06× over 1st-order, 16× chance baseline).
Covers:
- Pi 5 + Hailo hardware bring-up (BOM ~$580 + workstation)
- nexmon_csi native ARM build recipe (cross-compile is a dead end)
- Per-node services + per-host topology (15 expected services across 4 hosts)
- Workstation pipeline: 3 daemons + 7 timers, brain HTTP + SQLite
- 12 brain categories from spatial-vitals through rfmem-fleet
- cog-query CLI: 34 subcommands, 4 JSON modes, --post for 2
- Calibration recipe: walk → cluster → warm-start IDs → Markov chain
- 13-axis anomaly detector w/ composite info score (1.0–8.0)
- Fleet-health triad: check-drift + replica-status + fleet-status
- Troubleshooting table for the painful lessons (clock skew, cp -r footgun,
self-loop dominance in Markov argmax, etc.)
Pairs with a detailed cookbook gist (linked from intro + steps 3, 4,
and the Reference section):
https://gist.github.com/ruvnet/88e7b053c41cb4f4af7a7ec4af873017
Co-Authored-By: claude-flow <ruv@ruv.net>
Two amendments per ADR-207's "naming defect — fix immediately regardless" action item: 1. Intro callout: when the tutorial was first written, "rvcsi" was a naming convention only (no upstream library dep). As of 2026-05-13 the v0-appliance accepted ADR-207 Option D and shipped a Rust binary built on the real rvcsi-runtime. Both stacks can coexist on a mixed cluster during cutover. 2. Per-node services section: explicit note that cog-csi-emitter + cog-csi-adapter + cog-rvcsi-stream are being consolidated into one cog-rvcsi-pi Rust binary, with deploy + rollback commands and scope (per-Pi cutover, mixed clusters OK). The tutorial's overall instructions remain correct for both pre- and post-cutover deployments — fleet-status, the operator surface, and the architectural model are unchanged. Co-Authored-By: claude-flow <ruv@ruv.net>
Tokyo503
approved these changes
May 14, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds
docs/tutorials/pi5-cluster-cognitive-rf-observer.md— afield-tested walkthrough for building a 4-node Raspberry Pi 5 + 2×
Hailo-8 multistatic Wi-Fi CSI cognitive RF observer using rvcsi.
Built against the v0-appliance
v0.5.0-cognitive-rf-observermilestone:k-means w/ warm-start → 2nd-order Markov chain → SQLite brain corpus
over 1st-order, 16× chance baseline)
What's in the tutorial
documented dead end)
Companion gist
Detailed cookbook with every unit file, command, config:
https://gist.github.com/ruvnet/88e7b053c41cb4f4af7a7ec4af873017
Style fit
Mirrors existing docs/tutorials/cognitum-seed-pretraining.md format.
Test plan
🤖 Generated with claude-flow