Forkybot AI: Bytebot ottimizzato e messo in sicurezza

Questo è un fork ottimizzato e messo in sicurezza di Bytebot, un agente IA open source che controlla un desktop virtuale per automatizzare attività complesse.

Il progetto originale è stato archiviato ed è rimasto senza manutenzione. Questo fork recupera l'idea, la modernizza e la prepara per la produzione, applicando buone pratiche di ingegneria del software, sicurezza e documentazione.

🎯 Cosa fa questo progetto?

Immagina un dipendente virtuale che ha il proprio computer. Puoi dargli istruzioni in linguaggio naturale come "Scarica le fatture di questo mese dai miei tre portali dei fornitori e organizzale in una cartella" e l'agente aprirà il browser, navigherà nei portali, scaricherà i file e li organizzerà. Tutto in modo autonomo, ma con la possibilità che tu prenda il controllo in qualsiasi momento (Human-in-the-loop).

✨ Miglioramenti Chiave (Fasi di Ingegneria)

Questo fork non è una semplice copia. Sono state realizzate tre fasi di ingegneria per portarlo al livello successivo:

Fase A: Sicurezza (Patch di CVE-2026-78250)

• Mitigazione del ciclo infinito: Sono stati implementati limiti di sicurezza configurabili (MAX_TASK_ITERATIONS e TASK_TIMEOUT_MS) per prevenire la denegazione del servizio (DoS) e spese API incontrollate.
• Human-in-the-loop: Se un'attività supera i limiti, non fallisce. Passa a NEEDS_HELP affinché un umano intervenga e la riprenda.

Fase B: Ottimizzazione (Riduzione dell'85% delle dimensioni)

• Migrazione a Debian Bookworm-slim: Mantiene la piena compatibilità con glibc, VS Code e 1Password, ma elimina il software e gli strumenti di compilazione non necessari.
• Multi-Stage Build: L'immagine finale riduce le sue dimensioni da ~7 GB a ~1.09 GB, migliorando l'efficienza e riducendo la superficie di attacco.
• Pulizia profonda: Sono stati rimossi Thunderbird, xfce4-goodies e editor ridondanti.

Fase C: Validazione dell'Integrazione (Smoke Test)

• È stato verificato l'avvio concorrente del desktop, dell'agente, della UI e del database.
• È stata verificata la comunicazione interna (VNC sulla porta 9990) ed esterna (UI sulla porta 9992).

📚 Documentazione Viva (Obsidian)

Uno dei grandi contributi di questo fork è il suo Cervello del Progetto, un vault di Obsidian (vault/) che funge da contesto affinché l'IA (e gli umani) navighino nell'architettura senza perdersi. Include:

• ADR (Registri delle Decisioni Architetturali) che spiegano il perché di ogni modifica.
• Mappe dei File dettagliate per l'Agente, la UI e il Desktop Virtuale.
• Protocolli di Lavoro (PROTOCOLO_TRABAJO.md e PROTOCOLO_OBSIDIAN.md) che definiscono come deve lavorare un agente IA in questo progetto.

🛠️ Tecnologie Utilizzate

• Agente: NestJS (Node.js 20 Alpine)
• Desktop Virtuale: Debian Bookworm-slim, XFCE, Xvfb, TigerVNC
• Frontend: Next.js 15, Tailwind CSS, noVNC
• Database: PostgreSQL 16
• Infrastruttura: Docker, Docker Compose, Multi-Stage Builds

🚀 Come Iniziare

# Clonare il repository
git clone https://github.com/TU_USUARIO/forkybot_AI.git
cd forkybot_AI

# Configurare le variabili d'ambiente (es. Gemini API Key)
echo "GEMINI_API_KEY=tu_clave_aqui" > docker/.env

# Avviare lo stack
docker-compose -f docker/docker-compose.yml up -d

# Accedere all'interfaccia
# Apri http://localhost:9992 nel tuo browser