Files
family_home_lab/docs
Sam Rolfe 1ff6c41a51 dsh: remove the local Ollama models from the chat dropdown
Reverts the MODEL_CHOICES/MODEL_LABELS additions from 2609ab5. The .27 models are
gone from the family console, so the two dropdown entries would have been dead
options that error when selected (and they were offered to every user).

The list is back to exactly the original 10 cloud entries. Existing sessions that
still reference a removed id fall back to the default rather than erroring, since
the server validates the id against MODEL_CHOICES.

docs/dsh-architecture.md: drop the 'Local Ollama models' section, and add a warning
that auto/* are OmniRoute *routers* — when OmniRoute's pool is exhausted they fail
with 'Maximum combo retry limit reached' and DSH shows it as 'Model returned no
response', which is not a DSH bug.

Verified on .13: all four instances report 10 models with no ollama entries, and a
real streamed reply comes back through DSH on an explicit model.
2026-10-12 19:45:29 +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