WIKI/Overview/Architecture Overview
Overview

Architecture Overview

Frank's architecture has 5 layers, from user-facing to foundational:

Layer 5: User Interface

  • Web UI (port 8099): 7 pages — Web UI Guide for details
  • Overlay: Desktop notifications, consciousness stream
  • Voice: Push-to-talk via FrankVoice (Voice)

Layer 4: Cognitive Services

The thinking layer. 10+ services that run continuously:

Layer 3: Memory & Identity

Persistence — what makes Frank Frank across restarts:

Layer 2: Infrastructure

The plumbing:

Layer 1: Safety

The guardrails:

  • Neural Immune System: 18.8K-param service supervisor
  • Input pre-filters: hardcoded refusals for dangerous queries (0ms)
  • Ego Construct: Confabulation detection + hardware identity
  • Identity regex: prevents hallucinated name changes

Everything connects through the router (port 8091), which directs requests to the right LLM endpoint based on content type.

← ALL ARTICLES