Mindburn-Labs/helm-ai-kernel

¿Qué hace helm-ai-kernel?

Firewall de ejecución fail-closed para agentes de IA: pone en cuarentena herramientas MCP, actúa como proxy de solicitudes compatibles con OpenAI, emite recibos firmados y verifica EvidencePacks sin conexión.

Descripción general

helm-ai-kernel proporciona una capa de seguridad fundamental para agentes de IA autónomos. Al implementar un firewall de ejecución con política de fallo cerrado (fail-closed), garantiza que solo las acciones explícitamente autorizadas sean ejecutadas. Esto es crítico en entornos de producción donde los agentes de IA pueden acceder a sistemas sensibles, ejecutar comandos o interactuar con APIs externas.

Funcionalidades principales

• Cuarentena de herramientas MCP: Aísla y controla el acceso a herramientas del Model Context Protocol (MCP), previniendo su uso no autorizado por parte del agente.
• Proxy OpenAI-compatible: Intercepta y redirige solicitudes a la API de OpenAI (u otras APIs compatibles) permitiendo inspección, registro y control de políticas.
• Recibos firmados: Emite recibos criptográficos de cada acción ejecutada, proporcionando una pista de auditoría inmutable.
• Verificación offline de EvidencePacks: Valida paquetes de evidencia sin necesidad de conexión a internet, asegurando la integridad de las pruebas incluso en entornos aislados.

Plataformas compatibles

• Claude Code (Anthropic)
• Cursor (Cursor.sh)
• Codex CLI (OpenAI)
• Cualquier agente de IA que utilice el protocolo MCP o APIs compatibles con OpenAI

Uso básico

1. Instale el kernel usando npm:

   npm install @mindburn/helm-ai-kernel
   

2. Configure el firewall en su proyecto:

   import { HelmKernel } from '@mindburn/helm-ai-kernel';
   
   const kernel = new HelmKernel({
     policy: 'fail-closed',
     allowedTools: ['read-file', 'search-web'],
     proxyEndpoint: 'https://api.openai.com/v1',
   });
   
   await kernel.start();
   

3. Para verificar un EvidencePack offline:

   helm-verify --pack evidence-pack.json --public-key ./key.pub
   

Documentación completa

Para instrucciones detalladas, ejemplos y referencia de API, consulte la documentación oficial.

Licencia

Este proyecto está licenciado bajo la licencia MIT. Consulte el archivo LICENSE para más detalles.