Files
family_home_lab/docs
Sam Rolfe 990e433117 panel: remove the Ollama card and its controller entry
The local 14B model is not usable from this machine (8.25 tok/s prompt
processing; pi sends a 9,510-token agent prompt against a 4,096 context, so it
was truncated to 2,050 and still needed ~4 min before the first token). Nothing
about the panel was worth keeping for it.

- portal/tools.py: drop the 'Ollama Local LLM' tile (no other references remain)
- services.toml: drop the ollama allowlist entry; 8 services remain
- service_controller.py + docs: keep the generic 'systemd-system' kind but drop
  the ollama-specific wording and mark it as currently unused

Verified on .13: /api/services no longer lists ollama, the deployed tools.py has
0 ollama matches, the other 8 cards still report correctly, portal is healthy.
2026-10-12 19:39:45 +11:00
..

Family Home Lab Technical Documentation

This directory contains architectural specifications, component manuals, integration tables, and network registries for the Family Home Lab ecosystem.

Core Technical Reference Specs

  • DeepSeek Harness (DSH) Architecture: Multi-instance chat engine, per-user container allocation (sam, jo, harry, finn), ports (3081–3084), JSON session persistence, multi-model routing table (OmniRoute, OpenRouter, Whisper, Jervis Voice Agent), CSP framing, and API endpoints.

  • Console Portal Architecture: FastAPI application spec, user database schema, access control entitlement flags (can_chat, can_image, can_audio, can_docs), tool catalogue structure (tools.py), host-side service-controller bridge, ON/OFF RAM management, and Garage S3 file integration.

  • Host Network & Port Registry: Single source of truth network topology and port allocations across hosts .13 (containers/models), .35 (Caddy/Gitea/Outline), .27 (dev workstation), and .51.


Component Plans & Features