Configuration
Global config lives in okami.yaml (versioned, hot-reload via okami reload). Credentials live in .env (loaded automatically) — never in YAML. The rule: credentials a…
Precedence
okami.yaml— base config, versioned (no secrets).okami.local.yaml— local, non-versioned overrides (e.g. your LMStudio's api_base)..env/~/.okami/.env— secrets (keys, tokens); referenced as${ENV}in the YAML.
okami.yaml
default_provider: lmstudio
memory:
backend: sqlite-fts5 # | honcho | holographic
embedder: { enabled: true, model: text-embedding-nomic-embed-text-v1.5 }
contracts:
ui:
library: shadcn
component_source: '@/components/ui'
forbid_raw_css: true
forbid_inline_hex: true
require_component_source: true
learning:
auto_skill: true # distills a skill from non-trivial tasks
voice:
stt: { backend: whisper, model: small }
tts: { enabled: true, backend: edge, voice: pt-BR-AntonioNeural }Key reference
params default_provider string Provider used when none is passed. providers map Each provider: model, api_base, auth, tier, fallback, context_window. memory map backend (sqlite-fts5 | honcho | holographic), embedder, file limits. contracts.ui map Hard UI rules that become a gate (see Skills). learning.auto_skill bool Distills a skill from non-trivial tasks. true voice map STT (Whisper) and TTS (Edge) for audio channels. approvals.mode enum manual | smart | off | yolo (see Security). manual groups map Multi-agent meetings (members + moderator + cooldown). sandbox map backend (docker|local), mode, network, timeout.
.env (secrets)
# Claude → uses the 'claude' CLI (already logged in); no key here
# Codex → okami login codex (device auth)
# MiniMax → okami login minimax (device flow OAuth)
MIMO_API_KEY=... # MiMo needs an API keyHelpers
okami config showeffective config (secrets masked)okami config set <k> <v>secret goes to .env, the rest to localokami config get <k> · pathread a value · show where the files liveokami reloadhot-reload the config (no restart)