Repolode
Enviar
DobermanCore

DobermanCore/Doberman-Core

Uma camada de proteção em tempo de execução para agentes de programação com IA que controla cada chamada de ferramenta e retorna PASS, AUTH ou BLOCK antes da execução.

Ver no GitHubSite
Estrelas
247
Forks
44
Issues abertas
54
Último commit
há 9 dias

O que é?

Doberman é uma camada de autorização e proteção que fica no caminho de execução entre um agente de IA e suas ferramentas, como arquivos, shell, servidores MCP e APIs. Cada chamada de ferramenta recebe exatamente um veredito antes de ser executada: PASS para ações rotineiras, AUTH para ações sensíveis que exigem aprovação e BLOCK para ações perigosas que nunca são executadas. Funciona por meio de um proxy MCP transparente ou de hooks do host para Claude Code, Codex, OpenClaw e Cursor.

O sistema falha de forma segura: erros e casos não tratados bloqueiam a ação, e solicitações de aprovação sem resposta são negadas após um prazo. O aprendizado adaptativo pode tornar a política mais restritiva automaticamente, mas não pode flexibilizá-la sem aviso; para enfraquecer uma política, é necessária uma aprovação humana auditada, protegida por um fator de posse, como TOTP ou uma senha local. A política também pode ser salva no repositório como um arquivo doberman.policy.yaml, para que as alterações passem por revisão de código.

O projeto é feito em Python, pode ser instalado com pip como doberman-core e inclui uma CLI com os comandos setup, doctor, demo e dashboard, além de um conjunto de testes de benchmark que mede a taxa de ataques que contornam as proteções e a taxa de bloqueios excessivos de ações legítimas.

Recursos principais

  • 01Controla cada chamada de ferramenta com um veredito PASS, AUTH ou BLOCK antes da execução.
  • 02Funciona como proxy MCP transparente diante de qualquer servidor compatível com MCP.
  • 03Oferece hooks do host para Claude Code, Codex e Cursor (experimental).
  • 04Falha de forma segura e nunca flexibiliza a política sem aprovação humana auditada.
  • 05Aceita arquivos de política salvos no repositório e revisados junto com o código.
  • 06Inclui um dashboard com decisões em tempo real e aprovações pendentes.

Casos de uso

  • Impedir que um agente de programação com IA execute comandos destrutivos de shell, como rm -rf em um repositório.
  • Impedir que agentes leiam arquivos .env ou vazem chaves de API por meio de chamadas de ferramenta.
  • Exigir aprovação humana para ações sensíveis em fluxos de trabalho com agentes sem supervisão.
  • Auditar e aplicar políticas de uso de ferramentas em equipes que implantam agentes em uma frota de máquinas.

Início rápido

  1. 1

    Instale o Doberman pelo PyPI

    pip install doberman-core
  2. 2

    Ative o preenchimento automático com Tab no shell (opcional)

    doberman --install-completion
  3. 3

    Configure o Doberman para o Claude Code (escolha quais agentes proteger e ajuste as barreiras de segurança)

    doberman setup
  4. 4

    Confirme se a instalação está funcionando

    doberman doctor

Antes de usar

  • O status é alfa, então podem ocorrer mudanças incompatíveis.
  • As integrações com Codex e Cursor estão marcadas como experimentais.
  • Solicitações de aprovação são recusadas automaticamente após o tempo limite se não houver resposta.

Em coleções

Frameworks e apps de agentes de IA open sourceServidores MCPFerramentas de varredura, auditoria e inteligência de ameaças

Tópicos

#agent-security#ai-agents#guardrails#mcp#llm-security#authorization#python#ai-safety#llm#security

Perguntas frequentes

O que é Doberman-Core?
Uma camada de proteção em tempo de execução para agentes de programação com IA que controla cada chamada de ferramenta e retorna PASS, AUTH ou BLOCK antes da execução. Doberman é uma camada de autorização e proteção que fica no caminho de execução entre um agente de IA e suas ferramentas, como arquivos, shell, servidores MCP e APIs. Cada chamada de ferramenta recebe exatamente um veredito antes de ser executada: PASS para ações rotineiras, AUTH para ações sensíveis que exigem aprovação e BLOCK para ações perigosas que nunca são executadas. Funciona por meio de um proxy MCP transparente ou de hooks do host para Claude Code, Codex, OpenClaw e Cursor.
Doberman-Core é gratuito? Qual é a licença?
Doberman-Core é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
Doberman-Core ainda é mantido?
Manutenção ativa. O último commit de Doberman-Core foi em 29 de out. de 2026.
Para que posso usar Doberman-Core?
Impedir que um agente de programação com IA execute comandos destrutivos de shell, como rm -rf em um repositório. Impedir que agentes leiam arquivos .env ou vazem chaves de API por meio de chamadas de ferramenta. Exigir aprovação humana para ações sensíveis em fluxos de trabalho com agentes sem supervisão. Auditar e aplicar políticas de uso de ferramentas em equipes que implantam agentes em uma frota de máquinas.
Como instalar Doberman-Core?
Instale o Doberman pelo PyPI: pip install doberman-core Ative o preenchimento automático com Tab no shell (opcional): doberman --install-completion Configure o Doberman para o Claude Code (escolha quais agentes proteger e ajuste as barreiras de segurança): doberman setup Confirme se a instalação está funcionando: doberman doctor
Onde consigo Doberman-Core?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/DobermanCore/Doberman-Core

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados