Personal Jarvis / docs ← Back to site GitHub

Core Concepts

Brain Providers

Five interchangeable model providers, switching by voice, and the fallback chain that keeps you running.


The “Brain” is the language-model layer. Jarvis is multi-provider by mandate — no provider is hardcoded, and you choose which one answers.

The five providers

  • Claude (Anthropic)
  • Gemini (Google)
  • Grok (xAI)
  • OpenAI
  • OpenRouter — one key, many models

Each is configured under [brain.providers.*] and selected with [brain].primary. You only need keys for the providers you actually use.

Switch by voice

Provider switching is a first-class runtime operation, not a config-file edit:

“[wake word], switch to Gemini.”

[wake word] is a neutral documentation placeholder for the activation phrase supported by your selected wake-word provider. It is not a required product phrase.

It takes effect on your next command — no restart, no reload. The BrainManager owns the live switch.

The fallback chain

If your primary provider errors, rate-limits, or times out, the BrainManager falls through a smart chain to the next healthy provider rather than failing the command. You stay in the conversation; the swap is invisible.

The Ack tier

Separately from the deep brain, a fast Ack-Brain produces the sub-second spoken acknowledgement (see voice pipeline). It runs a small, fast model so the confirmation lands before the real answer is ready.

Workers use Claude Max

Background mission workers run through the claude-cli backend using a Claude Max OAuth session — so heavy work does not require a separate Anthropic API account. The interactive brain and the worker brain are configured independently.

Local vs cloud

Every provider class keeps a cloud-reachable default, so a keyless-local or GPU-less machine still runs entirely through the cloud. Local models are an installed-by-default upgrade whose weights download on first use — never bundled, never mandatory.