Sam Rolfe
449fdd02c5
- docs/hub-api.md: language decision (Go 1.25) with reason and the frozen v1 routes POST /ask, POST /approve, GET /health, including request/response schemas, bearer-token auth, timeouts, error shapes, logging, versioning, and a safety confirmation that no route is a high-consequence control. - Update README, hub_brief.md open items, and the outline docs so they no longer say the API is undecided or the language is open. Co-Authored-By: Paperclip <noreply@paperclip.ing>
1.6 KiB
1.6 KiB
Central AI Hub — Configuration & Environment
Writing Style: ASD-STE100 Simplified Technical English (
ste-writing).
Secrets
All secrets come from ~/.config/environment.d/10-secrets.conf on each machine.
Never hard-code a secret. Never commit a secret.
Relevant keys:
| Key | Use |
|---|---|
OMNIROUTE_API_KEY |
Model calls through OmniRoute. |
PAPERCLIP_API_KEY |
File jobs to Paperclip. Does not exist yet. |
TAVILY_API_KEY |
Web search. |
OL_API_KEY |
Outline docs. |
VIKUNJA_TOKEN |
Vikunja tasks. |
GITEA_TOKEN |
Gitea repository. |
HUB_TOKEN_PHONE |
Hub token for the phone app. |
HUB_TOKEN_ESP32 |
Hub token for the house voice. |
HUB_TOKEN_DSH |
Hub token for dsh chat. |
HUB_TOKEN_CONSOLE |
Hub token for the console portal. |
HUB_TOKEN_ADMIN |
Hub token for the admin app. The only trusted door. |
Services and Ports
| Service | Host | Port | Use |
|---|---|---|---|
| OmniRoute | 192.168.20.13 | 20129 | Model gateway. |
| Paperclip | 192.168.20.13 | 3100 | Job orchestration. |
| Jervis (voice) | 192.168.20.13 | 8501 | Speak and announce. |
| Home Assistant | 192.168.20.30 | 8123 | Devices and timers. |
| MQTT | 192.168.20.13 | 1883 | Voice topics. |
| Apprise | 192.168.20.35 | 8210 | Notifications. |
| Hub | 192.168.20.13 | 8787 | This service. Proposed default (HUB_PORT). |
Config Paths
- Brief:
hub_brief.md - Rules:
AGENTS.md - Docs:
docs/ - Outline context:
docs/outline/
Rule
A new project gets its own service, its own port, and its own folder. Do not merge a destination into the Hub.