Forkybot AI: Bytebot Otimizado e Seguro

Este é um fork otimizado e seguro do Bytebot, um agente de IA de código aberto que controla um desktop virtual para automatizar tarefas complexas.

O projeto original foi arquivado e ficou sem manutenção. Este fork resgata a ideia, a moderniza e a prepara para produção, aplicando boas práticas de engenharia de software, segurança e documentação.

🎯 O que este projeto faz?

Imagine um funcionário virtual que tem seu próprio computador. Você pode dar instruções em linguagem natural como "Baixe as faturas deste mês dos meus três portais de fornecedores e organize-as em uma pasta" e o agente abrirá o navegador, navegará pelos portais, baixará os arquivos e os organizará. Tudo de forma autônoma, mas com a possibilidade de você assumir o controle a qualquer momento (Human-in-the-loop).

✨ Melhorias Principais (Fases de Engenharia)

Este fork não é uma simples cópia. Foram realizadas três fases de engenharia para levá-lo ao próximo nível:

Fase A: Segurança (Patch do CVE-2026-78250)

• Mitigação de loop infinito: Foram implementados limites de segurança configuráveis (MAX_TASK_ITERATIONS e TASK_TIMEOUT_MS) para prevenir negação de serviço (DoS) e gastos descontrolados de API.
• Human-in-the-loop: Se uma tarefa ultrapassar os limites, ela não falha. Transiciona para NEEDS_HELP para que um humano intervenha e a retome.

Fase B: Otimização (Redução de 85% no tamanho)

• Migração para Debian Bookworm-slim: Mantém a compatibilidade total com glibc, VS Code e 1Password, mas elimina o software e as ferramentas de compilação desnecessárias.
• Multi-Stage Build: A imagem final reduz seu tamanho de ~7 GB para ~1.09 GB, melhorando a eficiência e reduzindo a superfície de ataque.
• Limpeza profunda: Foram removidos Thunderbird, xfce4-goodies e editores redundantes.

Fase C: Validação de Integração (Smoke Test)

• Verificou-se a inicialização concorrente do desktop, do agente, da UI e do banco de dados.
• Comprovou-se a comunicação interna (VNC na porta 9990) e externa (UI na porta 9992).

📚 Documentação Viva (Obsidian)

Uma das grandes contribuições deste fork é seu Cérebro do Projeto, um cofre do Obsidian (vault/) que serve como contexto para que a IA (e os humanos) naveguem pela arquitetura sem se perder. Inclui:

• ADRs (Registros de Decisões Arquiteturais) que explicam o porquê de cada mudança.
• Mapas de Arquivos detalhados para o Agente, a UI e o Desktop Virtual.
• Protocolos de Trabalho (PROTOCOLO_TRABALHO.md e PROTOCOLO_OBSIDIAN.md) que definem como um agente de IA deve trabalhar neste projeto.

🛠️ Tecnologias Utilizadas

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

🚀 Como Começar

# Clonar o repositório
git clone https://github.com/SEU_USUARIO/forkybot_AI.git
cd forkybot_AI

# Configurar as variáveis de ambiente (ex. Gemini API Key)
echo "GEMINI_API_KEY=sua_chave_aqui" > docker/.env

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

# Acessar a interface
# Abra http://localhost:9992 no seu navegador