Forkybot AI: Optimiertes und abgesichertes Bytebot

Dies ist ein optimierter und abgesicherter Fork von Bytebot, einem Open-Source-KI-Agenten, der einen virtuellen Desktop steuert, um komplexe Aufgaben zu automatisieren.

Das ursprüngliche Projekt wurde archiviert und blieb ohne Wartung. Dieser Fork rettet die Idee, modernisiert sie und macht sie produktionsreif, indem er bewährte Praktiken aus Software-Engineering, Sicherheit und Dokumentation anwendet.

🎯 Was macht dieses Projekt?

Stell dir einen virtuellen Mitarbeiter vor, der seinen eigenen Computer hat. Du kannst ihm Anweisungen in natürlicher Sprache geben wie „Lade die Rechnungen dieses Monats von meinen drei Lieferantenportalen herunter und sortiere sie in einem Ordner", und der Agent wird den Browser öffnen, durch die Portale navigieren, die Dateien herunterladen und sie organisieren. Alles autonom, aber mit der Möglichkeit, dass du jederzeit die Kontrolle übernimmst (Human-in-the-loop).

✨ Zentrale Verbesserungen (Engineering-Phasen)

Dieser Fork ist keine einfache Kopie. Es wurden drei Engineering-Phasen durchgeführt, um ihn auf die nächste Stufe zu heben:

Phase A: Sicherheit (Patch für CVE-2026-78250)

• Minderung von Endlosschleifen: Es wurden konfigurierbare Sicherheitsgrenzen implementiert (MAX_TASK_ITERATIONS und TASK_TIMEOUT_MS), um Denial-of-Service (DoS) und unkontrollierte API-Kosten zu verhindern.
• Human-in-the-loop: Wenn eine Aufgabe die Grenzen überschreitet, schlägt sie nicht fehl. Sie wechselt in den Zustand NEEDS_HELP, damit ein Mensch eingreifen und sie fortsetzen kann.

Phase B: Optimierung (85 % Größenreduktion)

• Migration zu Debian Bookworm-slim: Behält die vollständige Kompatibilität mit glibc, VS Code und 1Password bei, entfernt jedoch unnötige Software und Build-Tools.
• Multi-Stage Build: Das finale Image reduziert seine Größe von ~7 GB auf ~1,09 GB, was die Effizienz verbessert und die Angriffsfläche verringert.
• Tiefgehende Bereinigung: Thunderbird, xfce4-goodies und redundante Editoren wurden entfernt.

Phase C: Integrationsvalidierung (Smoke Test)

• Der gleichzeitige Start von Desktop, Agent, UI und Datenbank wurde verifiziert.
• Die interne Kommunikation (VNC auf Port 9990) und die externe Kommunikation (UI auf Port 9992) wurden überprüft.

📚 Lebendige Dokumentation (Obsidian)

Eine der großen Beiträge dieses Forks ist sein Projektgehirn, ein Obsidian-Vault (vault/), das als Kontext dient, damit die KI (und Menschen) sich durch die Architektur navigieren können, ohne sich zu verirren. Es enthält:

• ADRs (Architecture Decision Records), die das Warum jeder Änderung erklären.
• Dateikarten im Detail für den Agenten, die UI und den virtuellen Desktop.
• Arbeitsprotokolle (PROTOCOLO_TRABAJO.md und PROTOCOLO_OBSIDIAN.md), die definieren, wie ein KI-Agent in diesem Projekt arbeiten soll.

🛠️ Verwendete Technologien

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

🚀 Erste Schritte

# Clonar el repositorio
git clone https://github.com/TU_USUARIO/forkybot_AI.git
cd forkybot_AI

# Configurar las variables de entorno (ej. Gemini API Key)
echo "GEMINI_API_KEY=tu_clave_aqui" > docker/.env

# Levantar el stack
docker-compose -f docker/docker-compose.yml up -d

# Acceder a la interfaz
# Abre http://localhost:9992 en tu navegador