CraftBot

¿Qué es CraftBot?

CraftBot es un asistente de IA personal que se ejecuta en tu propia máquina y está diseñado para interpretar tareas, planificar acciones y ejecutarlas para ayudarte a lograr objetivos. Está pensado para funcionar de manera continua y así poder ayudarte proactivamente a planificar e iniciar tareas según tus preferencias y objetivos.

El proyecto soporta múltiples proveedores de modelos de lenguaje e incluye integraciones, un sistema de memoria y un marco extensible para ampliar lo que el agente puede hacer mediante MCP (Model Context Protocol) y habilidades personalizadas.

Características principales

• Sistema de proveedores LLM Bring Your Own Key (BYOK): Selecciona y cambia entre proveedores LLM compatibles como OpenAI, Google Gemini, Anthropic Claude, BytePlus y Ollama local.
• Sistema de memoria con consolidación diaria: Destila y consolida eventos del día a medianoche para soportar personalización continua.
• Comportamiento proactivo del agente (con aprobación): Aprende preferencias, hábitos y objetivos vitales; puede planificar e iniciar tareas, con la aprobación como parte del flujo de trabajo.
• Integración de herramientas externas con soporte OAuth: Conéctate a servicios como Google Workspace, Slack, Notion, Zoom, LinkedIn, Discord y Telegram (con más por venir).
• Integración MCP para capacidades extendidas: Usa Model Context Protocol para ampliar las capacidades del agente con herramientas y servicios externos.
• Marco de habilidades: Marco extensible de habilidades con habilidades integradas para planificación de tareas, investigación, revisión de código y operaciones git.

Cómo usar CraftBot

1. Instala los prerrequisitos: Usa Python 3.10+ y clona el repositorio. También necesitarás una clave API para tu proveedor LLM elegido (se mencionan OpenAI, Gemini o Anthropic).
2. Instala dependencias: Ejecuta python install.py desde el directorio clonado de CraftBot.
3. Inicia el agente: Ejecuta python run.py. La primera ejecución te guía en la configuración de tus claves API.
4. Elige un modo de interfaz:
   • Browser (predeterminado): python run.py (recomendado; requiere Node.js 18+).
   • TUI: python run.py --tui (sin dependencia de Node.js).
   • CLI: python run.py --cli.
   • GUI (experimental): python run.py --gui install.py --gui (el modo GUI se describe explícitamente como experimental; pueden ocurrir problemas al cambiar).
5. Comienza a interactuar: Usa lenguaje natural para hablar con el agente y ve comandos disponibles con /help. También puedes conectar integraciones como Google, Slack y Notion después de la configuración.

Casos de uso

• Planificación e inicio de tareas personales: Pide al agente que planifique tareas multi-paso e inicie trabajo alineado con tus preferencias y objetivos vitales, con aprobación en el flujo de trabajo.
• Asistencia entre herramientas en apps de trabajo: Usa las conexiones integradas (p. ej., Google Workspace, Slack, Notion, Zoom, LinkedIn, Discord, Telegram) para tareas que abarcan múltiples servicios.
• Extensión de capacidades vía MCP: Añade o conecta herramientas y servicios externos mediante MCP para que el agente interactúe con capacidades adicionales más allá de las integradas.
• Ayuda en flujos de trabajo para desarrolladores: Usa habilidades integradas como investigación, revisión de código y operaciones git para soportar trabajo de software directamente desde el asistente.
• Elección de interfaz adecuada para tu entorno: Ejecuta en modo browser para una interfaz web, usa TUI/CLI para flujos terminales ligeros o prueba el modo GUI experimental si quieres retroalimentación visual.

Preguntas frecuentes

• ¿Qué modelos puede usar CraftBot? CraftBot soporta un sistema BYOK LLM con múltiples proveedores, incluyendo OpenAI, Google Gemini, Anthropic Claude, BytePlus y Ollama local.

• ¿Necesito Node.js? Node.js 18+ es opcional y solo se requiere para la interfaz browser; si no está instalado, el instalador proporciona instrucciones o puedes usar el modo TUI.

• ¿Es estable el modo GUI? No—el modo GUI se describe como experimental y puedes encontrar problemas al cambiar a modo GUI. El proyecto indica mejoras activas.

• ¿Puedo extender lo que CraftBot puede hacer? Sí. El repositorio lista soporte para integraciones MCP y un marco de habilidades, ambos para extender las capacidades del agente.

• ¿Qué integraciones están soportadas de fábrica? La página lista integraciones para Google Workspace, Slack, Notion, Zoom, LinkedIn, Discord y Telegram, con credenciales embebidas y soporte OAuth.

Alternativas

• Agentes de IA locales con uso de herramientas construidos con frameworks: Si quieres una configuración similar de “agente se ejecuta en tu máquina” pero con un ecosistema diferente, busca frameworks que admitan llamadas a herramientas, memoria e intercambio de proveedores.
• Asistentes basados en chat con conexiones a herramientas externas: Si tu objetivo es un chat más simple con integraciones (en lugar de planificación/ejecución autónoma), considera asistentes que se centren en flujos de trabajo conversacionales con apps conectadas.
• Automatización de productividad en línea de comandos: Para usuarios que prefieren automatización sin un bucle de planificación de IA, las alternativas incluyen ejecutores de tareas y herramientas de automatización que orquestan acciones basadas en flujos de trabajo predefinidos.
• Configuraciones de agentes compatibles con MCP: Si tu necesidad principal es extender capacidades vía MCP, compara otras arquitecturas o implementaciones de agentes habilitadas para MCP que se ajusten a tu UI y conjunto de herramientas preferidos.