-----

## Funzionalità Principali

|Capability             |Description                                                                     |Data Source           |
|-----------------------|--------------------------------------------------------------------------------|----------------------|
|🔎 **Ricerca CVE**     |Analisi approfondita delle vulnerabilità con punteggio CVSS, stato delle patch e contesto degli exploit|NVD + CISA KEV        |
|🌐 **Analisi IOC**     |Controllo reputazionale per IP, domini, URL e hash di file                     |VirusTotal + AbuseIPDB|
|🧠 **Ricerca Neurale**    |Ricerca semantica nel deep-web per advisories oscuri e write-up tecnici       |Exa AI                |
|🤖 **Multi-Modello**      |Accesso unificato a oltre 400 LLM da OpenAI, Anthropic, Google e 50+ provider   |OpenRouter            |
|📰 **Briefing Giornalieri**  |Rassegne automatizzate di threat intelligence con tracciamento di incidenti notevoli            |Live feeds            |
|🛡️ **Generazione Policy**|Checklist di hardening per AWS, Azure, GCP, Kubernetes e Okta         |Framework-aligned     |
|🔴 **Red Teaming**      |Sfruttamento autonomo in sandbox, wrapping di sessioni C2 e movimento laterale    |Internal / C2         |
|🔌 **Protocollo MCP**     |Integrazione estensibile di strumenti tramite server Model Context Protocol                  |Custom + community    |
|✅ **Auto-verifica**|Validazione cross-source con blocchi di sicurezza difensivi e limitati all'engagement |Internal              |

-----

## Integrazione con lo Stack AI di NVIDIA

Gideon è progettato appositamente per sfruttare l'infrastruttura AI enterprise di NVIDIA — riconosciuto al **NVIDIA GTC 2026** come implementazione leader dello stack AI NVIDIA per le operazioni di sicurezza.```
┌─────────────────────────────────────────────────────────┐
│                   NVIDIA AI STACK                        │
├──────────────┬──────────────┬──────────────┬────────────┤
│     NIM      │   Morpheus   │ PersonaPlex  │    NeMo    │
│  GPU-accel   │   Threat     │  Voice AI    │ Guardrails │
│  local LLMs  │  Detection   │  Ops Mode    │  & Safety  │
└──────────────┴──────────────┴──────────────┴────────────┘
                       │
               ┌───────▼───────┐
               │    RAPIDS     │
               │  Accelerated  │
               │  IOC Analysis │
               └───────────────┘

**Modalità**: `bounty` · `pentest` · `research` · `ctf`

-----

### ☠️ Post-Exploitation [RED TEAM MODE]

> Operazioni autonome di post-sfruttamento per impegni autorizzati: mappatura AD, movimento laterale ed escalation dei privilegi.```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

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

> Operazioni di sicurezza a mani libere — narra le query, ricevi briefing parlati sulle minacce.```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

|Modulo                  |Funzione                                                    |
|------------------------|------------------------------------------------------------|
|Gateway Sentinel        |Monitora e convalida tutto il traffico agente in entrata/uscita   |
|Skill Scanner           |Rileva skill dannose o compromesse al caricamento        |
|Prompt Injection Defense|Rilevamento delle iniezioni in tempo reale su tutte le superfici di input     |
|Hardening Auditor       |Verifica la configurazione di distribuzione rispetto ai benchmark di sicurezza  |
|Credential Guard        |Monitora l'esposizione delle credenziali nella memoria dell'agente e negli output|
|Memory Monitor          |Rileva l'inquinamento del contesto e gli attacchi di manipolazione della memoria   |

**Copertura CVE**: CVE-2026-25253 · CVE-2026-24763 · CVE-2026-25157 · CVE-2026-22708 · campagna ClawHavoc

-----

## Architettura

Gideon implementa un ciclo agente **ReAct (Reasoning + Acting)** — pianifica, agisci, osserva, rifletti, ripeti — con un livello strumentale modulare e barriere di sicurezza ad ogni transizione.```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"

> Tutto qui. Nessun Docker. Nessun ambiente Python. Nessun tool di sicurezza sul tuo host. Solo Bun.

-----

## Configurazione

Tutta la configurazione risiede in `.env` e `gideon.config.yaml`.

### Provider LLM e Modelli

|Variabile          |Provider  |Note                                                 |
|--------------------|----------|------------------------------------------------------|
|`OPENROUTER_API_KEY`|OpenRouter|400+ modelli — consigliato per accesso multi-modello      |
|`OPENAI_API_KEY`    |OpenAI    |Accesso diretto a GPT-4o, o1                              |
|`ANTHROPIC_API_KEY` |Anthropic |Accesso diretto a Claude 3.5/3.7                          |
|`GOOGLE_API_KEY`    |Google    |Accesso diretto a Gemini Pro/Flash                        |
|`OLLAMA_BASE_URL`   |Ollama    |Endpoint LLM locale (predefinito: `http://127.0.0.1:11434`)|

### Threat Intelligence e Ricerca

|Variabile          |Servizio   |Note                                           |
|--------------------|----------|------------------------------------------------|
|`EXA_API_KEY`       |Exa AI    |Ricerca semantica neurale — ricerca tecnica approfondita|
|`TAVILY_API_KEY`    |Tavily    |Ricerca web generale per intelligence di sicurezza    |
|`NVD_API_KEY`       |NIST NVD  |Database CVE — limite di richieste senza chiave           |
|`VIRUSTOTAL_API_KEY`|VirusTotal|Reputazione IOC: file, URL, IP, domini       |
|`ABUSEIPDB_API_KEY` |AbuseIPDB |Reputazione IP e monitoraggio di attori malintenzionati      |

### Stack NVIDIA AI *(Opzionale — Avanzato)*

|Variabile           |Componente      |Note                        |
|-------------------|---------------|-----------------------------|
|`NVIDIA_API_KEY`   |NIM / NVIDIA AI|Inferenza accelerata GPU    |
|`NIM_BASE_URL`     |NIM            |Endpoint NIM locale           |
|`MORPHEUS_ENDPOINT`|Morpheus       |URL della pipeline di rilevamento minacce|
|`NEMO_CONFIG_PATH` |NeMo Guardrails|Percorso della configurazione dei guardrails    |

-----

## Utilizzo

### Shell Interattiva```bash
bun start

### Sessioni di Esempio

**Ricerca sulle Minacce**```
> 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...]

## Struttura del progetto```
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">

**Licenza MIT** · Costruito da [Cogensec](https://cogensec.com) — *per difensori, dai difensori*

[![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 — Il tuo assistente autonomo per le operazioni di cybersecurity.*

</div>