Architecture Deep Dive
A deep dive into Familiars' technical architecture, dissected section by section. Each section corresponds to the "long technical architecture video": the start of each section notes the matching video timestamp (to be recorded). Source: the repository's
ARCHITECTURE.md(the official architecture document), sliced into 10 parts for easy reading and searching.
Reading Path
| Part | Content | Source Section |
|---|---|---|
| 01 - System Overview & Frontend | System overview, Electron + Vue3 frontend, frontend↔Bridge communication | ARCHITECTURE §1–§2 |
| 02 - Bridge Layer | FastAPI bridge, route organization, SSE event pump, startup side-effect order | §3 |
| 03 - Agent Pipeline | Plan → execute → verify → synthesize → memory, model routing, tool system architecture | §4 |
| 04 - RAG & Memory | Dialogue trees, memory system, why not a vector database | §5 |
| 05 - Storage Layer | SQLite layering, file tree, migrations | §6 |
| 06 - Proactive Decision & Gifts | Decider local small model, gift pipeline | §7 |
| 07 - Digital Human | Multi-backend architecture, VRAM gating | §8 |
| 08 - Security & Monitoring | Security model, local Monitor, Daily Monitor, Cron/Todo/Reminder | §9–§10 |
| 09 - Ecosystem (Skills/Recipe/Broker/Flow) | Skills, recipes, Broker/exchange, multi-agent pipeline, flow engine | §11 |
| 10 - Engineering & Appendix | External agent adaptation, code organization, build & run, key change points | §12–§15 |
Suggested Reading Order
- First read: 01 → 03 → 04 → 05 → 08 (start with the "frontend → agent → memory → storage → security" main line);
- Dive deeper / recommended: 02, 06, 07 (Bridge / Decider / Digital Human);
- Interested in ecosystem development: 09 (Skills/Recipe/Broker/Flow) → continue with the Ecosystem Tutorial.