Perguntas frequentes
Respostas curtas para as dúvidas mais comuns. Não achou a sua? Abra uma issue no GitHub.
faq Preciso ter Python instalado? Não. O instalador usa o uv como motor — ele baixa o Python 3.11+, cria o ambiente isolado e instala tudo. O único pré-requisito é o git. Funciona offline / 100% local? Sim. Com um LMStudio local como provider e a memória holographic ou sqlite-fts5 (BM25), o agente roda sem rede. O embedder remoto é opcional e degrada para BM25 se estiver offline. Preciso pagar API? Não necessariamente. A postura é assinatura-only: Claude via o CLI claude e Codex/MiniMax via OAuth de assinatura. Modelos locais são grátis. Pay-as-you-go (API key) é opcional. Funciona no Windows? Sim. O instalador é um one-liner em PowerShell e o uv evita a dor de long-path do litellm. Se rodar do código sem uv, use um venv curto (ex.: C:\okv). É confiável com um modelo fraco ou pequeno? Sim — é o ponto central. A inteligência mora no harness: quanto mais fraco o modelo, mais ele decompõe, restringe (GBNF) e verifica. O piso da qualidade está no verificador, não no modelo. Como ele adere ao meu design system? Por contrato. okami.yaml → contracts.ui declara regras verificáveis (library, component_source, forbid_raw_css) que viram exitCriteria e são checadas por okami gate — o agente pode ser impedido de concluir se violar UI, componentes ou estilo. Como troco de modelo no meio da conversa? Use /model <id> para trocar o modelo da sessão e /think <nível> para o esforço de raciocínio. O fallback em cadeia também troca sozinho se um provider cair. Meus segredos vão parar no git? Não. Segredos ficam só no .env; um literal no YAML versionável reprova na policy. Além disso, run_shell roda com sanitized_env() — chaves e tokens são removidos do ambiente. Posso usar pelo Telegram? Sim. Defina o token do bot no agente e rode okami gateway. Há voz (Whisper + TTS), slash commands e go/no-go por chat. Dá para rodar vários agentes? Sim, em modo experimental. Cada agente é uma pasta (agents/<id>) com modelo, identidade e memória próprios. okami room testa conversa em grupo com moderador e turn-taking, mas ainda é uma área de validação do alpha. A persona muda sozinha? Posso reverter? Sim e sim. Um observador evolui VOICE/PERSONA a partir do seu jeito de falar; SOUL fica protegido. Tudo tem changelog append-only e /undo. Como contribuo? O projeto é open source no GitHub (OkamiOps/Okami-Agent). Issues e PRs são bem-vindos.