hsp-pi
v0.1.0
Published
HSP Relay for Pi — silent while the machine works, one R2 settle chatter when done
Maintainers
Readme
hsp-pi
HSP Relay for Pi — thin Pi package that starts/stops the HSP settle-chatter sidecar.
Silent while the machine works. One R2-style phrase when the episode settles.
pi install npm:hsp-pi
# or
pi install git:github.com/maximilianwruhs-cyber/hsp-piThen in Pi:
/hsp setup
/hsp run
/hsp pingWhat you get
| Piece | Role |
|-------|------|
| This package | Pi commands (/hsp …) + short skill |
| HSP binary | Real engine (hsp run / ping) — not bundled |
No auto-chatter on Pi agent end. The sidecar already speaks from load settle; a second lifecycle beep would stack sounds.
Quick start
- Install the HSP binary:
curl -fsSL https://raw.githubusercontent.com/maximilianwruhs-cyber/hsp-pi/main/scripts/install-hsp.sh | bashNeeds Rust (cargo), pkg-config, and ALSA headers (libasound2-dev on Debian/Ubuntu).
Or point at an existing build:
export HSP_BIN=/path/to/hsp
# default probes: ~/.local/bin/hsp, PATH, ~/github-clone/HSP/hsp-rs/target/release/hsp- Install this Pi package:
pi install npm:hsp-pi- In Pi:
/hsp status
/hsp runSidecar log + pid: ~/.local/state/hsp-pi/
Commands
| Command | Action |
|---------|--------|
| /hsp setup | Check binary; print install hints |
| /hsp status | Binary path + sidecar pid |
| /hsp run | Start detached hsp run |
| /hsp stop | Stop sidecar |
| /hsp ping | Speaker check |
| /hsp help | Short help |
Engine
Voice, grammar, and telemetry live in HSP (docs/CHARACTER.md, docs/SPEC.md). This repo is the Pi install surface only.
License
MIT
