Files
brain-of-reese/tests/fixtures/docs/homelab/kubernetes.md
T
ducoterra 022da8e2bc feat: scaffold Brain of Reese — FastAPI RAG chat over Postgres 17 + pgvector
Foundation (phase 01, verified):
- FastAPI app: /api/health, /api/suggestions, /api/chat (placeholder),
  static frontend served locally (no CDN)
- Postgres 17 + pgvector via db/Containerfile + compose.yaml
  (podman compose up -d db), Alembic initial migration (documents,
  chunks with vector(768), query_log)
- LLM client targeting https://aipi.reeseapps.com/v1 (turbo/embed);
  scripts/llm_probe.py verified models + 768-dim embeddings live
- Conditional debugpy: imported only when DEBUGPY=1 (attach on demand,
  :5678); logging config for clean single-line logs
- Frontend shell: mobile-first chat + Sources pages, tokens, a11y baselines
- Tests: 24 unit+integration (99% coverage on app/), ruff + pyright clean,
  Playwright smoke E2E (3 tests) against a deterministic mock LLM
- Planning: .agent/PLAN.md (architecture + LOCKED decisions), AGENTS.md,
  6 user stories, 7 phase files (one story / one phase / one Playwright
  suite each)
2026-08-21 13:42:21 -04:00

468 B

Kubernetes Homelab Cluster

Overview

The cluster runs Talos Linux on three nodes: two workers (i5-8500, 32GB) and one control plane.

Networking

Cilium handles networking and the L4/L7 proxy. Ingress is served via the Cilium Gateway API.

Storage

Local-path-provisioner provides scratch storage. Longhorn is intentionally not used.

Notable Workloads

  • Gitea (source control)
  • ntfy (push notifications)
  • Homepage (dashboard)
  • Uptime Kuma (monitoring)