Central AI Hub — System Overview

Writing Style: ASD-STE100 Simplified Technical English (ste-writing).

Purpose

The Hub is one service. Every way in reaches every ability through the Hub. Build each ability once. All ways in get it.

Today, Jervis (voice) and dsh (chat) each understand the user and act. A third way in, the phone app, would repeat the same work. The Hub stops this repeat.

The Five Steps

Hear — take voice or text from any way in.
Understand — the LLM works out what the user asked.
Check — test whether the user may ask for this.
Route — send the request to one destination.
Answer — return a short reply in the right shape.

Ways In

Phone app (Kotlin) — wake word, voice, controls.
Admin app (Kotlin) — restricted actions only.
ESP32 voice — "Hey Jervis".
dsh chat — per-person chat.
Console portal — web dashboard.

Destinations

Destination	Job
Home Assistant	Lights, switches, timers, calendar.
Speakers (Jervis)	Speak and announce.
Internet control	Parental limits on kids' devices.
Artemis	Operate the phone screen.
Paperclip	Slow, multi-step, recorded work.
Web search	Tavily search.
Apprise / NTFY	Notifications and email.

Reply Shapes

The Hub returns one reply. The reply can hold text, spoken audio (TTS), Artemis commands, a notification, or an email. TTS can play on the house speakers or on the phone. The Hub returns the reply to the source.

The Dividing Line

The Hub asks one question: does this need a decision, or does it need to happen?

Happen — fast and certain. Go straight to the destination. No LLM in the path of the action.
Decision — slow, multi-step, worth recording. Send to Paperclip.

What the Hub Is Not

Not a central brain. No single personality or memory.
Not Paperclip. The Hub does not wait minutes for an answer.
Not a destination. The Hub does not turn off the internet itself.

2.0 KiB Raw Blame History