Repolode
Justin0504

Justin0504/Aegis

Firewall en tiempo de ejecución para agentes de IA que intercepta, clasifica y bloquea llamadas a herramientas antes de que se ejecuten, con aprobaciones y un registro de auditoría a prueba de manipulaciones.

Estrellas
523
Forks
55
Issues abiertos
5
Último commit
hace 7 días

¿Qué es?

AEGIS se sitúa entre un agente de IA y las herramientas que utiliza. Cada llamada a una herramienta se clasifica por tipo (base de datos, archivo, red, shell, inyección de prompts, cadena de suministro), se comprueba según las políticas y las referencias de anomalías y, después, se permite, se retiene para su aprobación por una persona o se bloquea antes de ejecutarse. El proyecto está pensado para casos como consultas SQL destructivas, exfiltración de datos inesperada o comandos shell alucinados por un agente.

La integración se realiza mediante un SDK que envuelve clientes LLM de Python, TypeScript y Go, o mediante proxies HTTP y MCP stdio para agentes que no se pueden modificar. El gateway se ejecuta como un servicio Docker e incluye un panel Compliance Cockpit para consultar trazas en tiempo real, editar políticas, gestionar aprobaciones y activar un interruptor de emergencia. Las políticas se pueden escribir como reglas AJV JSON-Schema o mediante un DSL YAML por tenant que solo permite endurecer las decisiones.

Cada llamada permitida se registra en un log de trazas encadenado mediante hashes SHA-256, con firmas Ed25519 opcionales y un registro de transparencia RFC 6962 para la verificación offline. El proyecto cuenta con licencia MIT e incluye paquetes de cumplimiento, exportación a SIEM y OTLP, y una ontología de amenazas para agentes publicada.

Funciones clave

  • 01Clasifica cada llamada a una herramienta por tipo antes de evaluar las políticas, sin requerir anotaciones en las herramientas.
  • 02Retiene las llamadas de alto riesgo para que se aprueben manualmente en Cockpit antes de ejecutarse.
  • 03Incluye políticas predeterminadas para inyección SQL, acceso a archivos, acceso a la red e inyección de prompts.
  • 04Añade un DSL de políticas YAML por tenant que solo permite endurecer las decisiones.
  • 05Registra las trazas en un log de auditoría encadenado mediante hashes y, de forma opcional, firmado con Ed25519.
  • 06Funciona mediante SDK de Python, TypeScript y Go, un proxy HTTP y un proxy MCP.

Casos de uso

  • Aplicar barreras de protección a agentes que pueden ejecutar consultas SQL, comandos shell u operaciones con archivos.
  • Exigir la aprobación de una persona antes de que un agente publique paquetes o despliegue en Kubernetes.
  • Auditar el comportamiento de los agentes para revisiones de cumplimiento mediante logs a prueba de manipulaciones.
  • Controlar agentes de código cerrado o compilados dirigiendo su tráfico LLM y MCP a través de un proxy.

Inicio rápido

  1. 1

    Clona el repositorio

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

    Ve al directorio del proyecto

    cd Aegis
  3. 3

    Inicia los servicios con Docker Compose

    docker compose up -d
  4. 4

    Activa AEGIS en tu agente de Python importándolo una vez

    python -c "import agentguard; agentguard.auto('http://localhost:8080', agent_id='my-agent')"

Antes de usarlo

  • La descarga de la aplicación de escritorio solo está disponible actualmente para macOS con Apple Silicon; Windows aún no es compatible (se recomienda usar WSL2).
  • La configuración manual requiere Docker y ejecutar varios servicios localmente.

En colecciones

Temas

Preguntas frecuentes

¿Qué es Aegis?
Firewall en tiempo de ejecución para agentes de IA que intercepta, clasifica y bloquea llamadas a herramientas antes de que se ejecuten, con aprobaciones y un registro de auditoría a prueba de manipulaciones. AEGIS se sitúa entre un agente de IA y las herramientas que utiliza. Cada llamada a una herramienta se clasifica por tipo (base de datos, archivo, red, shell, inyección de prompts, cadena de suministro), se comprueba según las políticas y las referencias de anomalías y, después, se permite, se retiene para su aprobación por una persona o se bloquea antes de ejecutarse. El proyecto está pensado para casos como consultas SQL destructivas, exfiltración de datos inesperada o comandos shell alucinados por un agente.
¿Aegis es gratuito? ¿Qué licencia tiene?
Aegis es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿Aegis sigue mantenido?
Mantenimiento activo. El último commit de Aegis fue el 31 oct 2026.
¿Para qué puedo usar Aegis?
Aplicar barreras de protección a agentes que pueden ejecutar consultas SQL, comandos shell u operaciones con archivos. Exigir la aprobación de una persona antes de que un agente publique paquetes o despliegue en Kubernetes. Auditar el comportamiento de los agentes para revisiones de cumplimiento mediante logs a prueba de manipulaciones. Controlar agentes de código cerrado o compilados dirigiendo su tráfico LLM y MCP a través de un proxy.
¿Cómo se instala Aegis?
Clona el repositorio: git clone https://github.com/Justin0504/Aegis Ve al directorio del proyecto: cd Aegis Inicia los servicios con Docker Compose: docker compose up -d Activa AEGIS en tu agente de Python importándolo una vez: python -c "import agentguard; agentguard.auto('http://localhost:8080', agent_id='my-agent')"
¿Dónde consigo Aegis?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Justin0504/Aegis

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados