## Capacidades Principales

|Capacidad               |Descripción                                                                       |Fuente de Datos      |
|------------------------|----------------------------------------------------------------------------------|---------------------|
|🔎 **Investigación de CVE** |Análisis profundo de vulnerabilidades con puntuación CVSS, estado del parche y contexto de explotación|NVD + CISA KEV       |
|🌐 **Análisis de IOC**     |Verificación de reputación para IPs, dominios, URLs y hashes de archivos          |VirusTotal + AbuseIPDB|
|🧠 **Búsqueda Neuronal**   |Investigación semántica en la web profunda para avisos oscuros y documentos técnicos|Exa AI               |
|🤖 **Multi-Modelo**        |Acceso unificado a más de 400 LLMs de OpenAI, Anthropic, Google y más de 50 proveedores|OpenRouter           |
|📰 **Informes Diarios**    |Resúmenes automatizados de inteligencia de amenazas con seguimiento de incidentes notables|Fuentes en vivo      |
|🛡️ **Generación de Políticas**|Listas de verificación de refuerzo de seguridad para AWS, Azure, GCP, Kubernetes y Okta|Alineado con marcos  |
|🔴 **Red Teaming**         |Explotación autónoma en entorno aislado, envoltura de sesiones C2 y movimiento lateral|Interno / C2         |
|🔌 **Protocolo MCP**       |Integración extensible de herramientas a través de servidores de Protocolo de Contexto de Modelo|Personalizado + comunidad|
|✅ **Autoverificación**    |Validación entre fuentes con bloques de seguridad solo defensivos y alcance de engagement|Interno              |

-----

## Integración con el Stack de IA de NVIDIA

Gideon está diseñado para aprovechar la infraestructura de IA empresarial de NVIDIA — reconocido en **NVIDIA GTC 2026** como una implementación líder del stack de IA de NVIDIA para operaciones de seguridad.```
┌─────────────────────────────────────────────────────────┐
│                   NVIDIA AI STACK                        │
├──────────────┬──────────────┬──────────────┬────────────┤
│     NIM      │   Morpheus   │ PersonaPlex  │    NeMo    │
│  GPU-accel   │   Threat     │  Voice AI    │ Guardrails │
│  local LLMs  │  Detection   │  Ops Mode    │  & Safety  │
└──────────────┴──────────────┴──────────────┴────────────┘
                       │
               ┌───────▼───────┐
               │    RAPIDS     │
               │  Accelerated  │
               │  IOC Analysis │
               └───────────────┘

**Modos**: `bounty` · `pentest` · `research` · `ctf`

-----

### ☠️ Post-Explotación [MODO EQUIPO ROJO]

> Operaciones autónomas de post-explotación para compromisos autorizados: mapeo de AD, movimiento lateral y escalada de privilegios.```bash
> skills postex-help                   # Show command help
> skills post-exploitation lateral [IP]# Plan intelligent lateral movement
> skills post-exploitation sitrep      # Display C2 sessions and mapped hosts
> skills post-exploitation harvest     # Create credential harvesting playbooks

### 🎙️ Voz AI *(NVIDIA PersonaPlex)*

> Operaciones de seguridad manos libres — narra consultas, recibe informes de amenazas hablados.```bash
> skills voice speak [text]            # Text-to-speech output
> skills voice voice-set [voice-id]    # Select voice profile
> skills voice voice-list              # List available voices
> skills voice voice-enable            # Activate voice mode globally

|Módulo                  |Función                                                       |
|------------------------|--------------------------------------------------------------|
|Centinela de Pasarela   |Monitorea y valida todo el tráfico de agente entrante/saliente|
|Escáner de Habilidades  |Detecta habilidades maliciosas o comprometidas al cargarse    |
|Defensa contra Inyección de Prompts |Detección de inyecciones en tiempo real en todas las superficies de entrada|
|Auditor de Endurecimiento|Verifica la configuración de despliegue frente a líneas base de seguridad|
|Guardia de Credenciales |Monitorea exposición de credenciales en memoria y salidas del agente|
|Monitor de Memoria      |Detecta contaminación de contexto y ataques de manipulación de memoria|

**Cobertura de CVE**: CVE-2026-25253 · CVE-2026-24763 · CVE-2026-25157 · CVE-2026-22708 · Campaña ClawHavoc

-----

## Arquitectura

Gideon implementa un bucle de agente **ReAct (Reasoning + Acting)** — planificar, actuar, observar, reflexionar, repetir — con una capa de herramientas modular y barreras de seguridad en cada transición.```mermaid
flowchart TD
    CLI["🖥️ Gideon CLI\nInteractive Shell"] --> Core["⚙️ Agent Core\nReAct Loop"]

    Core --> Plan["🧠 Task Planning\n& Decomposition"]
    Core --> Reflect["🔄 Self-Reflection\n& Validation"]
    Core --> Tools["🔧 Tools & Skills Layer"]

    subgraph INTEL["📡 Threat Intelligence"]
        NVD["NVD + CISA KEV\nCVE Research"]
        VT["VirusTotal + AbuseIPDB\nIOC Reputation"]
        EXA["Exa AI\nNeural Search"]
        TAVILY["Tavily\nWeb Search"]
    end

    subgraph NVIDIA["🟢 NVIDIA AI Stack"]
        NIM["NIM\nLocal LLM Inference"]
        MORPHEUS["Morpheus\nThreat Pipelines"]
        PLEX["PersonaPlex\nVoice AI"]
        NEMO["NeMo Guardrails\nSafety Layer"]
        RAPIDS["RAPIDS\nData Analytics"]
    end

    subgraph MODELS["🤖 LLM Providers"]
        OR["OpenRouter\n400+ Models"]
        OAI["OpenAI"]
        ANT["Anthropic"]
        GGL["Google Gemini"]
        OLL["Ollama\nLocal"]
    end

    subgraph MCP["🔌 MCP Servers"]
        MCPS["Custom Tool Servers\nExtensible Protocol"]
    end

    Tools --> INTEL
    Tools --> NVIDIA
    Tools --> MODELS
    Tools --> MCP
    Reflect --> Core

**Windows**```powershell
powershell -c "irm bun.sh/install.ps1|iex"

> Eso es todo. Sin Docker. Sin entorno Python. Sin herramientas de seguridad en tu máquina. Solo Bun.

-----

## Configuración

Toda la configuración reside en `.env` y `gideon.config.yaml`.

### Proveedores de LLM y Modelos

|Variable            |Proveedor  |Notas                                                 |
|--------------------|-----------|------------------------------------------------------|
|`OPENROUTER_API_KEY`|OpenRouter |Más de 400 modelos — recomendado para acceso multi-modelo|
|`OPENAI_API_KEY`    |OpenAI     |Acceso directo a GPT-4o, o1                          |
|`ANTHROPIC_API_KEY` |Anthropic  |Acceso directo a Claude 3.5/3.7                       |
|`GOOGLE_API_KEY`    |Google     |Acceso directo a Gemini Pro/Flash                     |
|`OLLAMA_BASE_URL`   |Ollama     |Endpoint LLM local (por defecto: `http://127.0.0.1:11434`)|

### Inteligencia de Amenazas y Búsqueda

|Variable            |Servicio   |Notas                                           |
|--------------------|-----------|------------------------------------------------|
|`EXA_API_KEY`       |Exa AI     |Búsqueda semántica neuronal — investigación técnica profunda|
|`TAVILY_API_KEY`    |Tavily     |Búsqueda web general para inteligencia de seguridad|
|`NVD_API_KEY`       |NIST NVD   |Base de datos CVE — límite de tasa sin clave|
|`VIRUSTOTAL_API_KEY`|VirusTotal |Reputación de IOCs: archivos, URLs, IPs, dominios|
|`ABUSEIPDB_API_KEY` |AbuseIPDB  |Reputación de IP y seguimiento de actores maliciosos|

### Stack de IA de NVIDIA *(Opcional — Avanzado)*

|Variable           |Componente      |Notas                        |
|-------------------|----------------|-----------------------------|
|`NVIDIA_API_KEY`   |NIM / NVIDIA AI |Inferencia acelerada por GPU |
|`NIM_BASE_URL`     |NIM             |Endpoint NIM local           |
|`MORPHEUS_ENDPOINT`|Morpheus        |URL del pipeline de detección de amenazas|
|`NEMO_CONFIG_PATH` |NeMo Guardrails |Ruta a la configuración de guardrails|

-----

## Uso

### Shell Interactivo```bash
bun start

### Sesiones de ejemplo

**Investigación de amenazas**```
> What are the latest Ivanti vulnerabilities being exploited in the wild?

🔍 Planning research...
  ├── Query NVD for Ivanti CVEs (last 90 days)
  ├── Cross-reference CISA KEV catalog
  ├── Neural search for exploit write-ups and PoC reports
  └── Synthesize threat actor TTPs

[Results: 4 critical CVEs, 2 in CISA KEV, active exploitation by UNC5337...]

## Estructura del Proyecto```
Gideon/
├── src/
│   ├── agent/          # Core ReAct agent loop + task planner
│   ├── tools/          # CVE, IOC, search, policy tool implementations
│   ├── skills/         # Modular skills system
│   │   ├── security/   # Security research skill
│   │   ├── voice/      # NVIDIA PersonaPlex voice AI
│   │   ├── detection/  # NVIDIA Morpheus threat detection
│   │   ├── governance/ # NeMo guardrails + audit
│   │   └── sentinel/   # OpenClaw Sentinel security sidecar
│   ├── providers/      # LLM provider adapters (OpenAI, Anthropic, OpenRouter...)
│   ├── mcp/            # MCP server integrations
│   └── config/         # Configuration loader + validator
├── mcp-servers/        # Custom MCP server implementations
├── docs/               # Extended documentation
├── gideon.config.yaml  # Main configuration
├── env.example         # Environment template
└── package.json

<div align="center">

**Licencia MIT** · Construido por [Cogensec](https://cogensec.com) — *para defensores, por defensores*

[![Website](https://img.shields.io/badge/website-gideon.cogensec.com-blue?style=flat-square)](http://gideon.cogensec.com)
[![LinkedIn](https://img.shields.io/badge/LinkedIn-Cogensec-0077B5?style=flat-square&logo=linkedin)](https://linkedin.com/company/cogensec)
[![X](https://img.shields.io/badge/X-@cogensec-black?style=flat-square&logo=x)](https://x.com/cogensecai)

*Gideon — Su asistente autónomo de operaciones de ciberseguridad.*

</div>