family_home_lab/docs/README.md

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

• Audio Plan: MIDI transcription (Basic Pitch) and sheet music generation (MuScriptor).
• DSH Plugins Shortlist: Curated index of DeepSeek Harness extension plugins.
• DSH Plugin Plan: Roadmap for integrating summary and media plugins into DSH.
• Websites & Services Inventory: Catalogue of public domains and upstream destinations.
• Interactive Architecture Map: Visual HTML component map.