Forkybot AI : Bytebot optimisé et sécurisé

Il s'agit d'un fork optimisé et sécurisé de Bytebot, un agent d'IA open source qui contrôle un bureau virtuel pour automatiser des tâches complexes.

Le projet original a été archivé et n'est plus maintenu. Ce fork ressuscite l'idée, la modernise et la prépare pour la production, en appliquant les bonnes pratiques d'ingénierie logicielle, de sécurité et de documentation.

🎯 Que fait ce projet ?

Imaginez un employé virtuel qui dispose de son propre ordinateur. Vous pouvez lui donner des instructions en langage naturel comme « Télécharge les factures de ce mois depuis mes trois portails fournisseurs et organise-les dans un dossier » et l'agent ouvrira le navigateur, naviguera sur les portails, téléchargera les fichiers et les organisera. Le tout de manière autonome, mais avec la possibilité que vous preniez le contrôle à tout moment (Human-in-the-loop).

✨ Améliorations clés (phases d'ingénierie)

Ce fork n'est pas une simple copie. Trois phases d'ingénierie ont été réalisées pour le faire passer au niveau supérieur :

Phase A : Sécurité (correctif de CVE-2026-78250)

• Atténuation de la boucle infinie : des limites de sécurité configurables (MAX_TASK_ITERATIONS et TASK_TIMEOUT_MS) ont été implémentées pour prévenir le déni de service (DoS) et les dépenses d'API incontrôlées.
• Human-in-the-loop : si une tâche dépasse les limites, elle n'échoue pas. Elle passe à l'état NEEDS_HELP afin qu'un humain intervienne et la reprenne.

Phase B : Optimisation (réduction de 85 % de la taille)

• Migration vers Debian Bookworm-slim : conserve la compatibilité totale avec glibc, VS Code et 1Password, mais élimine les logiciels et les outils de compilation inutiles.
• Multi-Stage Build : l'image finale réduit sa taille de ~7 Go à ~1,09 Go, améliorant l'efficacité et réduisant la surface d'attaque.
• Nettoyage approfondi : Thunderbird, xfce4-goodies et les éditeurs redondants ont été supprimés.

Phase C : Validation de l'intégration (Smoke Test)

• Le démarrage concurrent du bureau, de l'agent, de l'UI et de la base de données a été vérifié.
• La communication interne (VNC sur le port 9990) et externe (UI sur le port 9992) a été contrôlée.

📚 Documentation vivante (Obsidian)

L'une des grandes contributions de ce fork est son Cerveau du Projet, un coffre Obsidian (vault/) qui sert de contexte pour que l'IA (et les humains) naviguent dans l'architecture sans se perdre. Il comprend :

• des ADR (Architecture Decision Records) qui expliquent le pourquoi de chaque changement.
• des Cartes de Fichiers détaillées pour l'Agent, l'UI et le Bureau Virtuel.
• des Protocoles de Travail (PROTOCOLO_TRABAJO.md et PROTOCOLO_OBSIDIAN.md) qui définissent comment un agent d'IA doit travailler sur ce projet.

🛠️ Technologies utilisées

• Agent : NestJS (Node.js 20 Alpine)
• Bureau Virtuel : Debian Bookworm-slim, XFCE, Xvfb, TigerVNC
• Frontend : Next.js 15, Tailwind CSS, noVNC
• Base de données : PostgreSQL 16
• Infrastructure : Docker, Docker Compose, Multi-Stage Builds

🚀 Comment démarrer

# Cloner le dépôt
git clone https://github.com/TU_USUARIO/forkybot_AI.git
cd forkybot_AI

# Configurer les variables d'environnement (ex. Gemini API Key)
echo "GEMINI_API_KEY=tu_clave_aqui" > docker/.env

# Lancer la stack
docker-compose -f docker/docker-compose.yml up -d

# Accéder à l'interface
# Ouvrez http://localhost:9992 dans votre navigateur