Forkybot AI: оптимизированный и защищённый Bytebot

Это оптимизированный и защищённый форк Bytebot — AI-агента с открытым исходным кодом, который управляет виртуальным рабочим столом для автоматизации сложных задач.

Оригинальный проект был заархивирован и остался без поддержки. Этот форк возрождает идею, модернизирует её и готовит к продакшену, применяя лучшие практики разработки ПО, безопасности и документирования.

🎯 Что делает этот проект?

Представьте виртуального сотрудника с собственным компьютером. Вы можете давать ему инструкции на естественном языке, например: «Скачай счета за этот месяц с трёх порталов моих поставщиков и разложи их по папкам» — и агент откроет браузер, пройдёт по порталам, скачает файлы и разложит их. Всё автономно, но с возможностью в любой момент взять управление на себя (Human-in-the-loop).

✨ Ключевые улучшения (этапы инженерии)

Этот форк — не простая копия. Были выполнены три этапа инженерии, чтобы вывести его на новый уровень:

Этап A: Безопасность (патч CVE-2026-78250)

• Устранение бесконечного цикла: реализованы настраиваемые ограничения безопасности (MAX_TASK_ITERATIONS и TASK_TIMEOUT_MS) для предотвращения отказа в обслуживании (DoS) и неконтролируемых расходов на API.
• Human-in-the-loop: если задача превышает лимиты, она не завершается ошибкой. Она переходит в состояние NEEDS_HELP, чтобы человек вмешался и возобновил её.

Этап B: Оптимизация (сокращение размера на 85%)

• Переход на Debian Bookworm-slim: сохраняется полная совместимость с glibc, VS Code и 1Password, но удаляются ненужное программное обеспечение и инструменты сборки.
• Multi-Stage Build: итоговый образ уменьшается с ~7 ГБ до ~1.09 ГБ, что повышает эффективность и сокращает поверхность атаки.
• Глубокая очистка: удалены Thunderbird, xfce4-goodies и избыточные редакторы.

Этап C: Проверка интеграции (Smoke Test)

• Проверен одновременный запуск рабочего стола, агента, UI и базы данных.
• Проверена внутренняя связь (VNC на порту 9990) и внешняя (UI на порту 9992).

📚 Живая документация (Obsidian)

Одно из главных достоинств этого форка — его Мозг проекта, хранилище Obsidian (vault/), которое служит контекстом, чтобы ИИ (и люди) могли ориентироваться в архитектуре без потерь. Оно включает:

• ADR (записи архитектурных решений), объясняющие почему было принято каждое изменение.
• Карты файлов с подробным описанием агента, UI и виртуального рабочего стола.
• Протоколы работы (PROTOCOLO_TRABAJO.md и PROTOCOLO_OBSIDIAN.md), определяющие, как AI-агент должен работать в этом проекте.

🛠️ Используемые технологии

• Агент: NestJS (Node.js 20 Alpine)
• Виртуальный рабочий стол: Debian Bookworm-slim, XFCE, Xvfb, TigerVNC
• Frontend: Next.js 15, Tailwind CSS, noVNC
• База данных: PostgreSQL 16
• Инфраструктура: Docker, Docker Compose, Multi-Stage Builds

🚀 Как начать

# 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