// operação · 05

Desenvolver e contribuir

O Okami é Python 3.11+, empacotado com Hatchling e gerenciado por uv. O código está organizado por domínio, os testes são pytest e a postura de segurança é versiona…

Abrir na documentação completa GitHub

Ambiente local

git clone https://github.com/OkamiOps/Okami-Agent.git
cd Okami-Agent
uv sync --extra dev
uv run okami doctor
uv run pytest -q

Extras opcionais

extra	inclui
dev	pytest, ruff, bandit e pip-audit
voice	faster-whisper e edge-tts
honcho	honcho-ai para memória externa
browser	playwright para automação de browser

Gates de qualidade

uv run pytest -qsuíte completa

okami policy checkconformance autorada

okami policy check --strictpostura de produção/GA

okami doctor --lintlint de exposição e segurança

scripts/secret-scan.shvarredura de segredo antes de publicar

Áreas de teste

A suíte cobre os pontos críticos: harness, parsing de tool-calls, gateway, sessões, Telegram nonce, sandbox, safe IO, checkpoints, memória, policy, provider catalog, OAuth, TUI, processos, API HTTP, Paperclip e conformance CI.

Padrão para PR

Mantenha mudança pequena e ligada a uma capacidade documentada.
Atualize docs quando adicionar comando, config key, provider, channel ou tool.
Inclua teste focado no contrato novo ou regressão corrigida.
Rode pelo menos pytest do módulo tocado, okami policy check e o gate de segredo se mexeu com auth/config.

GitHubCódigo e issues.Mapa do repoOnde cada módulo vive.

Abrir esta página nos docs interativos