# hsp-pi

**HSP Relay for [Pi](https://pi.dev)** — thin Pi package that starts/stops the [HSP](https://github.com/maximilianwruhs-cyber/HSP) settle-chatter sidecar.

Silent while the machine works. One R2-style phrase when the episode settles.

```bash
pi install npm:hsp-pi
# or
pi install git:github.com/maximilianwruhs-cyber/hsp-pi
```

Then in Pi:

```text
/hsp setup
/hsp run
/hsp ping
```

---

## What 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

1. Install the HSP binary:

```bash
curl -fsSL https://raw.githubusercontent.com/maximilianwruhs-cyber/hsp-pi/main/scripts/install-hsp.sh | bash
```

Needs Rust (`cargo`), `pkg-config`, and ALSA headers (`libasound2-dev` on Debian/Ubuntu).

Or point at an existing build:

```bash
export HSP_BIN=/path/to/hsp
# default probes: ~/.local/bin/hsp, PATH, ~/github-clone/HSP/hsp-rs/target/release/hsp
```

2. Install this Pi package:

```bash
pi install npm:hsp-pi
```

3. In Pi:

```text
/hsp status
/hsp run
```

Sidecar 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](https://github.com/maximilianwruhs-cyber/HSP)** (`docs/CHARACTER.md`, `docs/SPEC.md`). This repo is the Pi install surface only.

---

## License

MIT