honcho: document deriver disabled-by-default and manual start procedure
- Explains why honcho_deriver_autostart defaults to false (0 token burn) - Provides manual systemctl start/stop commands - Notes override procedure for permanent enable
This commit is contained in:
@@ -36,9 +36,42 @@ rootful Podman + Quadlet.
|
||||
4. Deploys a pgvector-enabled Postgres 16 container and waits for it to be
|
||||
ready.
|
||||
5. Deploys the Honcho API container (`honcho-api`) — FastAPI on :8000.
|
||||
6. Deploys the Honcho deriver worker container (`honcho-deriver`).
|
||||
6. Deploys the Honcho deriver worker container (`honcho-deriver`) — **stopped
|
||||
and disabled by default** (see below).
|
||||
7. Verifies the API answers on `/docs`.
|
||||
|
||||
## Deriver service (disabled by default)
|
||||
|
||||
The `honcho-deriver` service is **created but not started** by default
|
||||
(`honcho_deriver_autostart: false`). This prevents autonomous token burn.
|
||||
|
||||
**Why disabled:**
|
||||
The deriver runs background reasoning loops that consume LLM tokens
|
||||
continuously, independent of the Hermes client-side `contextCadence` and
|
||||
`dialecticCadence` settings. Even with both cadences set to zero in
|
||||
`~/.hermes/honcho.json`, the deriver polls Postgres every second and fires
|
||||
Claude API calls autonomously.
|
||||
|
||||
In production, this discovered behavior cost $10 USD overnight before the
|
||||
service was stopped.
|
||||
|
||||
**Manual start (if needed for testing):**
|
||||
|
||||
```bash
|
||||
# On lincoln.local.mk-labs.cloud as jarvis or with sudo:
|
||||
sudo systemctl start honcho-deriver.service
|
||||
|
||||
# Check status:
|
||||
sudo systemctl status honcho-deriver.service
|
||||
|
||||
# Stop again:
|
||||
sudo systemctl stop honcho-deriver.service
|
||||
```
|
||||
|
||||
**To enable permanently:**
|
||||
Override `honcho_deriver_autostart: true` in `group_vars` or inventory, then
|
||||
re-run the playbook.
|
||||
|
||||
## Required vault entries
|
||||
|
||||
Add to `group_vars/all/vault` (ansible-vault encrypted):
|
||||
|
||||
Reference in New Issue
Block a user