// começar · 02
Instalação
O único pré-requisito é o git. O instalador usa o uv como motor — ele baixa o Python 3.11+, cria o ambiente isolado e instala tudo. Você não precisa de Python insta…
Linux / macOS / WSL
curl -fsSL https://okamiagent.com/install.sh | bashgit clone https://github.com/OkamiOps/Okami-Agent
cd Okami-Agent
./scripts/install.shO que o instalador faz
- Detecta (ou baixa via uv) o Python 3.11+ e cria um venv isolado.
- Instala o pacote e expõe o comando
okamiglobal. - Não toca no seu Python de sistema nem exige sudo.
Windows (PowerShell)
irm https://okamiagent.com/install.ps1 | iexDocker (qualquer SO)
docker build -f deploy/Dockerfile -t okami-agent .
docker compose -f deploy/docker-compose.yml run --rm okami doctor
docker compose run --rm okami run "diga oi"Para um LMStudio rodando na máquina host, aponte api_base para http://host.docker.internal:PORT/v1.
Rodar do código (dev)
uv sync # cria o venv + deps a partir do pyproject
uv run okami doctor # roda sem ativar nada
uv tool install -e . # editável global (opcional)Extras opcionais
| extra | habilita |
|---|---|
| uv sync --extra voice | voz: faster-whisper (STT) + edge-tts (TTS) |
| uv sync --extra honcho | backend de memória honcho-ai |
| uv sync --extra browser | automação de browser via Playwright |
| uv sync --extra dev | pytest (suíte de testes) |
Verificar a instalação
okami doctor é o seu primeiro comando: ele checa providers, chaves, conectividade, toolchain (git, uv, node, docker, claude), suporte a SQLite FTS5, o embedder de memória e a política de sandbox. Use --json para CI e --lint para um lint de postura de segurança.
Solução de problemas
| sintoma | causa · correção |
|---|---|
| okami não encontrado | PATH desatualizado → reabra o terminal |
| claude_cli não pronto | instale e logue o CLI claude |
| codex sem auth | rode okami login codex |
| SQLite FTS5 ausente | memória cai para LIKE → use um Python com FTS5 |
| embedder offline | degrada para BM25 automaticamente (ok) |
| long-path no Windows | use um venv curto, ex. C:\okv |