Salon_Assistant/docs/ARCHITECTURE.md

Architecture (operator summary)

Full design: design/DESIGN_PLAN.md.

Layers

Host (bootstrap, Docker, product scripts, nemohermes/openshell CLIs)
  → OpenShell gateway (credentials, L7 policy, sandbox lifecycle)
    → Hermes sandbox (minimal Lumina profile)
         skills, channels, MCP clients (allowlisted)
  → External OpenAI-compatible model (outside containers OK)

How it flows

For the end-to-end narrative (design → implement → install → runtime → owner chat), see the root README section "How the project flows."

Related design docs

• Planes
• Det vs inference
• MCP integrations
• Updates lifecycle
• Platform research notes