CraftBot

O que é CraftBot?

CraftBot é um assistente de IA pessoal que roda no seu computador e foi projetado para interpretar tarefas, planejar ações e executá-las para ajudar a alcançar objetivos. Ele é projetado para funcionar continuamente, ajudando proativamente a planejar e iniciar tarefas com base nas suas preferências e objetivos.

O projeto suporta múltiplos provedores de modelos de linguagem e inclui integrações, um sistema de memória e um framework extensível para expandir o que o agente pode fazer por meio de MCP (Model Context Protocol) e habilidades personalizadas.

Principais Recursos

• Sistema de provedores LLM BYOK (Bring Your Own Key): Selecione e alterne entre provedores LLM suportados, incluindo OpenAI, Google Gemini, Anthropic Claude, BytePlus e Ollama local.
• Sistema de memória com consolidação diária: Destila e consolida eventos do dia à meia-noite para suportar personalização contínua.
• Comportamento proativo do agente (com aprovação): Aprende preferências, hábitos e objetivos de vida; pode planejar e iniciar tarefas, com aprovação registrada no fluxo de trabalho.
• Integração com ferramentas externas com suporte a OAuth: Conecte-se a serviços como Google Workspace, Slack, Notion, Zoom, LinkedIn, Discord e Telegram (com mais por vir).
• Integração MCP para capacidades expandidas: Usa Model Context Protocol para estender capacidades do agente com ferramentas e serviços externos.
• Framework de habilidades: Framework extensível de habilidades com habilidades integradas para planejamento de tarefas, pesquisa, revisão de código e operações git.

Como Usar o CraftBot

1. Instale os pré-requisitos: Use Python 3.10+ e clone o repositório. Você também precisará de uma chave de API para o provedor LLM escolhido (OpenAI, Gemini ou Anthropic são mencionados).
2. Instale as dependências: Execute python install.py no diretório clonado do CraftBot.
3. Inicie o agente: Execute python run.py. Na primeira execução, ele o guiará na configuração das chaves de API.
4. Escolha um modo de interface:
   • Browser (padrão): python run.py (recomendado; requer Node.js 18+).
   • TUI: python run.py --tui (sem dependência de Node.js).
   • CLI: python run.py --cli.
   • GUI (experimental): python run.py --gui (modo GUI é explicitamente descrito como experimental; problemas podem ocorrer ao alternar).
5. Comece a interagir: Use linguagem natural para conversar com o agente e veja comandos disponíveis com /help. Você também pode conectar integrações como Google, Slack e Notion após a configuração.

Casos de Uso

• Planejamento e iniciação de tarefas pessoais: Peça ao agente para planejar tarefas de múltiplos passos e iniciar trabalho alinhado com suas preferências e objetivos de vida, com fluxo de trabalho incluindo aprovação.
• Assistência entre ferramentas em apps de trabalho: Use as conexões integradas (ex.: Google Workspace, Slack, Notion, Zoom, LinkedIn, Discord, Telegram) para ajudar em tarefas que abrangem múltiplos serviços.
• Expansão de capacidades via MCP: Adicione ou conecte ferramentas e serviços externos por meio de MCP para que o agente interaja com capacidades além das integradas.
• Ajuda em fluxos de trabalho para desenvolvedores: Use habilidades integradas como pesquisa, revisão de código e operações git para suportar trabalho de software diretamente do assistente.
• Escolha de interface adequada ao seu ambiente: Rode em modo browser para interface web, use TUI/CLI para fluxos leves em terminal ou tente o modo GUI experimental para feedback visual.

Perguntas Frequentes

• Quais modelos o CraftBot pode usar? CraftBot suporta um sistema BYOK LLM com múltiplos provedores, incluindo OpenAI, Google Gemini, Anthropic Claude, BytePlus e Ollama local.

• Preciso do Node.js? Node.js 18+ é opcional e necessário apenas para a interface browser; se não instalado, o instalador fornece instruções ou use o modo TUI.

• O modo GUI é estável? Não — o modo GUI é descrito como experimental, e você pode encontrar problemas ao alternar para ele. O projeto menciona melhorias ativas.

• Posso expandir o que o CraftBot faz? Sim. O repositório lista suporte a integrações MCP e um framework de habilidades, ambos para expandir capacidades do agente.

• Quais integrações são suportadas de imediato? A página lista integrações para Google Workspace, Slack, Notion, Zoom, LinkedIn, Discord e Telegram, com credenciais embutidas e suporte a OAuth.

Alternativas

• Agentes de IA locais com uso de ferramentas construídos com frameworks: Se você quer uma configuração similar de “agente roda no seu computador” mas com um ecossistema diferente, procure frameworks que suportem chamadas de ferramentas, memória e alternância de provedores.
• Assistentes baseados em chat com conexões a ferramentas externas: Se o seu objetivo é um chat mais simples com integrações (em vez de planejamento/execução autônomos), considere assistentes que focam em fluxos conversacionais com apps conectados.
• Automação de produtividade via linha de comando: Para usuários que preferem automação sem um loop de planejamento de IA, alternativas incluem runners de tarefas e ferramentas de automação que orquestram ações baseadas em fluxos de trabalho predefinidos.
• Configurações de agentes compatíveis com MCP: Se a sua principal necessidade é estender capacidades via MCP, compare outras arquiteturas ou implementações de agentes habilitados para MCP para combinar com a sua UI e conjunto de ferramentas preferidos.