Controles de segurança que bloqueiam, pausam e auditam ações de agentes de IA antes da execução, para Claude Code, OpenClaw e agentes MCP.
Justin0504/Aegis
Firewall em tempo de execução para agentes de IA que intercepta, classifica e bloqueia chamadas de ferramentas antes da execução, com aprovações e uma trilha de auditoria à prova de adulteração.
- Estrelas
- 523
- Forks
- 55
- Issues abertas
- 5
- Último commit
- há 7 dias
O que é?
O AEGIS fica entre um agente de IA e as ferramentas que ele chama. Cada chamada de ferramenta é classificada por tipo (banco de dados, arquivo, rede, shell, prompt injection, cadeia de suprimentos), verificada em relação a políticas e padrões de anomalia e, então, liberada, retida para aprovação humana ou bloqueada antes de ser executada. O projeto se destina a casos como SQL destrutivo, exfiltração inesperada de dados ou comandos de shell alucinados pelo agente.
A integração é feita por meio de um SDK que encapsula clientes LLM em Python, TypeScript e Go, ou por proxies HTTP e MCP stdio para agentes que não podem ser modificados. O gateway é executado como um serviço Docker com um painel Compliance Cockpit para acompanhar traces em tempo real, editar políticas, aprovar chamadas e acionar um botão de emergência. As políticas podem ser escritas como regras AJV JSON-Schema ou em uma DSL YAML por tenant, que só permite tornar as decisões mais restritivas.
Cada chamada liberada é registrada em um log de traces encadeado por hashes SHA-256, com assinaturas Ed25519 opcionais e um log de transparência RFC 6962 para verificação offline. O projeto tem licença MIT e inclui pacotes de compliance, exportação para SIEM e OTLP e uma ontologia de ameaças a agentes publicada.
Recursos principais
- 01Classifica cada chamada de ferramenta por tipo antes da avaliação das políticas, sem exigir anotações nas ferramentas.
- 02Retém chamadas de alto risco para aprovação humana no Cockpit antes da execução.
- 03Inclui políticas padrão para SQL injection, acesso a arquivos, acesso à rede e prompt injection.
- 04Adiciona uma DSL de políticas YAML por tenant que só permite tornar as decisões mais restritivas.
- 05Registra traces em um log de auditoria encadeado por hashes e, opcionalmente, assinado com Ed25519.
- 06Funciona por meio de SDKs para Python, TypeScript e Go, além de proxies HTTP e MCP.
Casos de uso
- Adicionar proteções a agentes que podem executar SQL, comandos de shell ou operações com arquivos.
- Exigir aprovação humana antes de um agente publicar pacotes ou fazer deploy no Kubernetes.
- Auditar o comportamento de agentes em revisões de compliance com logs à prova de adulteração.
- Controlar agentes de código fechado ou compilados, roteando o tráfego de LLM e MCP por um proxy.
Início rápido
- 1
Clone o repositório
git clone https://github.com/Justin0504/Aegis - 2
Acesse o diretório do projeto
cd Aegis - 3
Inicie os serviços com o Docker Compose
docker compose up -d - 4
Ative o AEGIS no seu agente Python importando-o uma vez
python -c "import agentguard; agentguard.auto('http://localhost:8080', agent_id='my-agent')"
Antes de usar
- O download do aplicativo para desktop está disponível atualmente apenas para macOS com Apple Silicon; o Windows ainda não é compatível (recomenda-se usar o WSL2).
- A configuração manual requer Docker e a execução de vários serviços localmente.
Em coleções
Tópicos
Perguntas frequentes
- O que é Aegis?
- Firewall em tempo de execução para agentes de IA que intercepta, classifica e bloqueia chamadas de ferramentas antes da execução, com aprovações e uma trilha de auditoria à prova de adulteração. O AEGIS fica entre um agente de IA e as ferramentas que ele chama. Cada chamada de ferramenta é classificada por tipo (banco de dados, arquivo, rede, shell, prompt injection, cadeia de suprimentos), verificada em relação a políticas e padrões de anomalia e, então, liberada, retida para aprovação humana ou bloqueada antes de ser executada. O projeto se destina a casos como SQL destrutivo, exfiltração inesperada de dados ou comandos de shell alucinados pelo agente.
- Aegis é gratuito? Qual é a licença?
- Aegis é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- Aegis ainda é mantido?
- Manutenção ativa. O último commit de Aegis foi em 31 de out. de 2026.
- Para que posso usar Aegis?
- Adicionar proteções a agentes que podem executar SQL, comandos de shell ou operações com arquivos. Exigir aprovação humana antes de um agente publicar pacotes ou fazer deploy no Kubernetes. Auditar o comportamento de agentes em revisões de compliance com logs à prova de adulteração. Controlar agentes de código fechado ou compilados, roteando o tráfego de LLM e MCP por um proxy.
- Como instalar Aegis?
- Clone o repositório: git clone https://github.com/Justin0504/Aegis Acesse o diretório do projeto: cd Aegis Inicie os serviços com o Docker Compose: docker compose up -d Ative o AEGIS no seu agente Python importando-o uma vez: python -c "import agentguard; agentguard.auto('http://localhost:8080', agent_id='my-agent')"
- Onde consigo Aegis?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Justin0504/Aegis
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
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.
Aplicação de políticas, identidade zero trust, sandbox de execução e ferramentas de SRE para agentes de IA autônomos, com suporte a Python, TypeScript, .NET, Rust e Go.
Um mecanismo determinístico de políticas entre agentes de IA e suas ferramentas, que bloqueia chamadas capazes de enviar dados confidenciais a destinos não autorizados.
Memória local-first e freio pré-ordem para agentes de trading com IA, que registra decisões em uma cadeia de auditoria SHA-256 à prova de adulteração e oferece 20 ferramentas MCP.
Biblioteca Elixir para integrar LLMs como Claude, OpenAI, Gemini, Ollama e modelos self-hosted a aplicações Elixir.