Configuration System
Klaus uses a hybrid configuration system:
- Primary:
~/.klaus/config.toml (TOML format)
- Fallback:
.env file (via python-dotenv)
- Runtime: Module-level constants exported from
config.py
RuntimeSettings
Dataclass containing all runtime configuration values.
@dataclass(frozen=True)
class RuntimeSettings:
anthropic_api_key: str
openai_api_key: str
tavily_api_key: str
obsidian_vault_path: str
push_to_talk_key: str
toggle_key: str
camera_device_index: int
camera_frame_width: int
camera_frame_height: int
camera_rotation: str
mic_device_index: int
tts_voice: str
tts_speed: float
input_mode: str
vad_sensitivity: int
vad_silence_timeout: float
vad_min_duration: float
vad_min_voiced_ratio: float
vad_min_voiced_frames: int
vad_min_rms_dbfs: float
vad_min_voiced_run_frames: int
stt_moonshine_model: str
stt_moonshine_language: str
user_background: str
enable_query_router: bool
router_model: str
router_timeout_ms: int
router_max_tokens: int
router_local_confidence_threshold: float
router_local_margin_threshold: float
router_llm_confidence_threshold: float
system_prompt: str
Core Functions
get_runtime_settings()
Retrieve the current runtime settings.
def get_runtime_settings() -> RuntimeSettings:
Current runtime configuration
reload()
Re-read config.toml and update module-level constants.
Call after the setup wizard writes new values so that components created afterward pick up the fresh configuration.
Location: config.py:874-894
is_setup_complete()
Check whether the first-run wizard has been completed.
def is_setup_complete() -> bool:
True if setup_complete is set in config.toml
API Key Management
set_api_key()
Persist one API key using Keychain on macOS with config fallback.
def set_api_key(slug: str, value: str) -> None:
API key identifier: “anthropic”, “openai”, or “tavily”
API key value (empty string to clear)
save_api_keys()
Persist all three API keys at once.
def save_api_keys(anthropic: str, openai: str, tavily: str) -> None:
clear_api_key()
Remove a stored API key from Keychain/config.
def clear_api_key(slug: str) -> None:
API key identifier: “anthropic”, “openai”, or “tavily”
get_api_key_sources()
Get the source of each API key (“keychain”, “env”, “config”, or “missing”).
def get_api_key_sources() -> dict[str, str]:
Mapping from slug to source string
Device Settings
set_camera_index()
Update the active camera index and optionally persist it.
def set_camera_index(index: int, persist: bool = True) -> None:
Whether to write to config.toml
save_camera_index()
Persist camera index to config.toml without updating runtime variable.
def save_camera_index(index: int) -> None:
Camera device index to save
set_mic_index()
Update the active microphone index and optionally persist it.
def set_mic_index(index: int, persist: bool = True) -> None:
Microphone device index (-1 for system default)
Whether to write to config.toml
save_mic_index()
Persist microphone index to config.toml without updating runtime variable.
def save_mic_index(index: int) -> None:
Microphone device index to save (-1 for system default)
Profile Settings
save_user_background()
Persist the user background description to config.toml.
def save_user_background(text: str) -> None:
User background description (injected into system prompt)
save_obsidian_vault_path()
Persist the Obsidian vault path to config.toml.
def save_obsidian_vault_path(path: str) -> None:
Absolute path to Obsidian vault folder
mark_setup_complete()
Set setup_complete = true in config.toml.
def mark_setup_complete() -> None:
Module-Level Constants
After config loading, the following constants are exported at module level:
CLAUDE_MODEL: str = "claude-sonnet-4-6"
TTS_MODEL: str = "gpt-4o-mini-tts"
ANTHROPIC_API_KEY: str
OPENAI_API_KEY: str
TAVILY_API_KEY: str
OBSIDIAN_VAULT_PATH: str
PUSH_TO_TALK_KEY: str
TOGGLE_KEY: str
CAMERA_DEVICE_INDEX: int
CAMERA_FRAME_WIDTH: int
CAMERA_FRAME_HEIGHT: int
CAMERA_ROTATION: str
MIC_DEVICE_INDEX: int
TTS_VOICE: str
TTS_SPEED: float
INPUT_MODE: str
VAD_SENSITIVITY: int
VAD_SILENCE_TIMEOUT: float
VAD_MIN_DURATION: float
VAD_MIN_VOICED_RATIO: float
VAD_MIN_VOICED_FRAMES: int
VAD_MIN_RMS_DBFS: float
VAD_MIN_VOICED_RUN_FRAMES: int
STT_MOONSHINE_MODEL: str
STT_MOONSHINE_LANGUAGE: str
USER_BACKGROUND: str
ENABLE_QUERY_ROUTER: bool
ROUTER_MODEL: str
ROUTER_TIMEOUT_MS: int
ROUTER_MAX_TOKENS: int
ROUTER_LOCAL_CONFIDENCE_THRESHOLD: float
ROUTER_LOCAL_MARGIN_THRESHOLD: float
ROUTER_LLM_CONFIDENCE_THRESHOLD: float
SYSTEM_PROMPT: str
File Paths
DATA_DIR = Path.home() / ".klaus"
DB_PATH = DATA_DIR / "klaus.db"
CONFIG_PATH = DATA_DIR / "config.toml"
config.toml file supports:
- Top-level keys for device indices, hotkeys, TTS voice, VAD parameters, etc.
- Optional
[api_keys] section (legacy, superseded by Keychain on macOS)
- Comments with
#
Default values are applied for any missing keys. See config.py:22-124 for the full template.
System Prompt
The system prompt is dynamically built from:
- Base personality and brevity rules
user_background (if provided)- Voice style rules
- Notes capability instructions
See _build_system_prompt() at config.py:323-332 and _SYSTEM_PROMPT_BODY at config.py:335-443.