// conceitos · 07
Mapa do repositório e runtime
O Okami tem duas estruturas diferentes: o pacote Python (okami/) e o runtime criado quando você usa o agente. Entender essa divisão evita confundir código versionad…
Raiz do projeto
| caminho | papel |
|---|---|
| okami/ | pacote principal: CLI, harness, providers, channels, memória, skills e integrações |
| tests/ | suíte pytest cobrindo harness, gateway, sandbox, memória, providers, TUI, API e policy |
| skills/ | skills empacotadas com SKILL.md, escaneadas antes de uso |
| examples/company/ | empresa multi-agente de exemplo: cto, ui e backend |
| deploy/ | Dockerfile e docker-compose para rodar em container |
| scripts/ | instaladores install.sh e install.ps1 |
| docs/ | arquitetura, produção, estrutura, roadmap e pesquisa competitiva |
| okami.yaml / okami.policy.yaml | config base e postura de conformance autorada |
Pacote okami/
core/ harness · tools · approval · sandbox · safe_io
llm/ providers · transports · oauth · retry · imagegen
cli/ comandos Typer por domínio
gateway/ endpoint · sessions · checkpoints · approvals · groups
channels/ terminal · telegram · slack · discord · mattermost · paperclip
agents/ load_agents · Router · grupos multi-agente
memory/ sqlite_fts5 · holographic · honcho · layered · compaction
learning/ auto-skill · persona · taste · tuning
automation/ scheduler · event hooks
integrations/ mcp · acp · browser · references
voice/ STT · TTS · bridgeRuntime por agente
Cada agente é uma pasta com modelo, identidade, memória e sessões próprias. Credenciais ficam globais; a escolha de modelo e canal fica no agente.
agents/<id>/
agent.yaml # role, default_provider, channels
SOUL.md · VOICE.md · PERSONA.md
.okami/
sessions/<chat>.jsonl # transcript append-only
memory.db · taste.json · persona_signals.json
checkpoints/journal.jsonl
audit.jsonl · events.jsonl · tool_outputs/Estado global
$OKAMI_HOME (default ~/.okami) concentra segredos globais, credenciais OAuth, agentes migrados e binários instalados pelo launcher. O projeto continua limpo: .okami/, agentes e workspaces são runtime e não devem ir para o git.