Repolode
Justin0504

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. 1

    Clone o repositório

    git clone https://github.com/Justin0504/Aegis
  2. 2

    Acesse o diretório do projeto

    cd Aegis
  3. 3

    Inicie os serviços com o Docker Compose

    docker compose up -d
  4. 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