CraftBot
La mayoría de los agentes se quedan en el chat y las llamadas a herramientas. CraftBot va más allá. Construye, hace evolucionar y opera sus propias herramientas SaaS, y luego usa esa capa de herramientas para comunicarse contigo y automatizar tu trabajo. Además de eso, CraftBot incluye todas las capacidades básicas de un agente de propósito general. Ejecuta tareas como lo haría un empleado remoto, recuerda tus preferencias y objetivos, y te ayuda de forma proactiva a planificar y actuar sobre lo que más te importa.

Windows macOS Linux GitHub Repo stars License Discord Ask DeepWiki

[![SPONSORED BY E2B FOR STARTUPS](https://img.shields.io/badge/SPONSORED%20BY-E2B%20FOR%20STARTUPS-ff8800?style=for-the-badge)](https://e2b.dev/startups)

English | 日本語 | 简体中文 | 繁體中文 | 한국어 | Português | Français | Deutsch

## ✨ Características destacadas Más allá de ser un agente de IA capaz de crear y operar sus propias herramientas SaaS, CraftBot incluye todas las capacidades básicas de un agente, lo que le permite funcionar como un agente de propósito general que te acompaña en tus tareas, herramientas, memoria y flujos de trabajo diarios. - **Perfiles de agente** Más de 40 perfiles de agente (agente CEO, agente de finanzas, agente líder de marketing, ingeniero DevOps, agente productor de vídeo y 37 más) listos para trabajar para ti. Encuentra los roles que deseas en **[CraftBot Agent Bundles](https://github.com/CraftOS-dev/craftbot-agent-bundles)** e impórtalos con un solo clic. - **Catálogo de playbooks** ¿No sabes cómo automatizar con un agente IA? CraftBot incluye 120 playbooks listos para usar (en 19 categorías). Abre el selector de playbooks desde la barra superior, elige uno y empezará a ejecutar la tarea por ti. - **Agent App.** Crea, importa o haz evolucionar aplicaciones personalizadas que viven dentro de CraftBot. El agente conoce en todo momento el estado de la UI y puede leer, escribir y actuar directamente sobre sus datos. - **Multitarea y enrutamiento de sesiones.** ¿Sigues escribiendo `/new` a mano? CraftBot decide cuándo iniciar una nueva sesión y cuándo retomar una tarea existente, manteniendo unificados la conversación y el contexto. - **Autohospedado y BYOK.** Sistema flexible de proveedores LLM compatible con OpenAI, Google Gemini, Anthropic Claude, OpenRouter y más. O aloja tu propio modelo sin gastar tokens usando Ollama. - **Sistema de memoria.** Un segundo cerebro construido a partir de tus interacciones con CraftBot. Enfoque híbrido: RAG + grafo de conocimiento + sistema de archivos del agente. CraftBot "sueña" a medianoche y consolida los eventos del día. - **Agente proactivo.** Aprende tus preferencias, hábitos y objetivos de vida. Luego planifica e inicia tareas (con tu aprobación, por supuesto) para ayudarte a mejorar. - **Integración con herramientas externas.** Conecta tus aplicaciones como Google Workspace, Slack, Notion, Zoom, LinkedIn, Discord, Telegram y más (¡y vienen más!), con soporte para OAuth o usando tu propia clave. Puedes conectar varias cuentas a cada integración. - **Skills y MCP.** Más de 150 MCP y 170 Skills listos para usar. Instalación rápida de nuevas Skills y MCPs. Crea o mejora Skills a partir de tareas completadas con un solo clic. - **Interfaz de navegador y soporte de CLI.** Usa CraftBot como mejor te encaje: con una UI de navegador sencilla para el día a día, o desde la CLI para scripting y entornos headless. --- ## 🧰 Primeros pasos Requisitos: Python 3.10+ · Node.js 18+ para el modo navegador ```bash # 1. Clona el repositorio git clone https://github.com/CraftOS-dev/CraftBot.git cd CraftBot # 2. Instala, registra el autoinicio y lanza CraftBot python craftbot.py install ``` Eso es todo. La terminal se cierra sola, CraftBot queda corriendo en segundo plano y el navegador se abre automáticamente. Además se crea un **acceso directo en el escritorio** para que puedas reabrir el navegador cuando quieras. **Gestión del servicio tras la instalación:** ```bash python craftbot.py start # Inicia CraftBot en segundo plano python craftbot.py stop # Detiene CraftBot python craftbot.py restart # Reinicia CraftBot python craftbot.py status # Comprueba si está corriendo y si el autoinicio está activo python craftbot.py logs # Muestra la salida reciente de logs python craftbot.py uninstall # Detiene, quita el autoinicio y desinstala los paquetes ``` > [!TIP] > Tras `install` o `start` se crea automáticamente un **acceso directo de CraftBot en el escritorio**. Si cierras el navegador, basta con hacer doble clic en él para volver a abrirlo. --- ## 🌱 Agent App **Agent App es un sistema/app/dashboard que evoluciona con tus necesidades.**
CraftBot Banner
- ¿Necesitas un tablero kanban con un copiloto de IA incorporado? - ¿Un CRM a medida que encaje exactamente con tu flujo de trabajo? - ¿Un dashboard corporativo que CraftBot pueda leer y operar por ti? Ponlo en marcha como una Agent App que se ejecuta junto a CraftBot y crece a medida que cambian tus necesidades. ### Tres formas de crear una Agent App 1. **Construir desde cero.** Describe en lenguaje natural lo que quieres. CraftBot genera el modelo de datos, la API de backend y la UI en React, y luego itera contigo a través de un proceso de diseño estructurado.
Building a Agent App from scratch
2. **Instalar desde el marketplace.** Explora las Agent Apps creadas por la comunidad en [living-ui-marketplace](https://github.com/CraftOS-dev/living-ui-marketplace).
Agent App marketplace
3. **Importar un proyecto existente.** Indícale a CraftBot un proyecto en Go, Node.js, Python, Rust, o código estático o un repositorio de GitHub. Detecta el runtime, configura los health checks y lo envuelve como una Agent App.
Importing an existing project as a Agent App
### Sigue evolucionando con CraftBot dentro del bucle Una Agent App nunca está "terminada". Pídele al agente que añada funciones, rediseñe una vista o la conecte con nuevos datos según tus necesidades cambien. CraftBot está embebido en cada Agent App y es **consciente de su estado**: puede leer el DOM y los valores de los formularios, consultar los datos de la app a través de la API REST y disparar acciones en tu nombre. ### Mantén las herramientas SaaS abiertas y vivas Construye, personaliza y haz evolucionar tu propia Agent App, y depende menos de herramientas por suscripción que nunca se diseñaron para encajar perfectamente con tus necesidades. --- # Tres Agent Apps que puedes probar en 5 minutos - **📋 Tablero Kanban**: Cada tarea, seguimiento y CTA en un solo lugar. CraftBot puede manejarlo para hacer el trabajo de PM por ti. - **📊 Habit Tracker**: Desarrolla y mantén tus hábitos. Un calendario de actividad al estilo GitHub para seguir tus hábitos como un desarrollador. - **🐦 Luolinglo**: No es Duolingo, pero puedes aprender nuevos idiomas, crear flashcards y practicar con CraftBot. **[Explora y contribuye al marketplace de Agent App →](https://craftos.net/marketplace)** --- ## 🔧 Solución de problemas y preguntas frecuentes ### Falta Node.js (para el modo navegador) Si al ejecutar `python run.py` ves **"npm not found in PATH"**: 1. Descarga la versión LTS desde [nodejs.org](https://nodejs.org/) 2. Instálala y reinicia la terminal 3. Vuelve a ejecutar `python run.py` **Alternativa:** Usa el modo CLI (no necesita Node.js): ```bash python run.py --cli ``` ### La instalación falla por dependencias El instalador ahora muestra mensajes de error detallados con posibles soluciones. Si falla: - **Comprueba la versión de Python:** asegúrate de tener Python 3.10+ (`python --version`) - **Comprueba la conexión a internet:** las dependencias se descargan durante la instalación - **Limpia la caché de pip:** ejecuta `pip install --upgrade pip` y vuelve a intentarlo ### Problemas al instalar Playwright La instalación de Chromium de Playwright es opcional. Si falla: - El agente **seguirá funcionando** para el resto de tareas - Puedes saltártelo e instalarlo más tarde con `playwright install chromium` - Solo es necesario para la integración con WhatsApp Web Para una solución de problemas más detallada, consulta [INSTALLATION_FIX.md](INSTALLATION_FIX.md). --- ## 🐳 Ejecutar con un contenedor La raíz del repositorio incluye una configuración Docker con Python 3.10, los paquetes de sistema clave (incluido Tesseract para OCR) y todas las dependencias de Python definidas en `requirements.txt`, de modo que el agente puede ejecutarse de forma consistente en entornos aislados. A continuación tienes las instrucciones para correr nuestro agente con un contenedor. ### Construir la imagen Desde la raíz del repositorio: ```bash docker build -t craftbot . ``` ### Ejecutar el contenedor La imagen está configurada para lanzar el agente con `python -m app.main` por defecto. Para ejecutarlo de forma interactiva: ```bash docker run --rm -it craftbot ``` Si necesitas pasar variables de entorno, usa un archivo env (por ejemplo, basado en `.env.example`): ```bash docker run --rm -it --env-file .env craftbot ``` Monta con `-v` los directorios que deban persistir fuera del contenedor (por ejemplo carpetas de datos o caché) y ajusta puertos u otros parámetros según tu despliegue. La imagen trae dependencias del sistema para OCR (`tesseract`) y clientes HTTP habituales, de modo que el agente pueda trabajar con archivos y APIs de red dentro del contenedor. Por defecto, la imagen usa Python 3.10 y empaqueta las dependencias de Python de `requirements.txt`, así que `python -m app.main` funciona sin más. --- ## 🤝 Cómo contribuir ¡Los PRs son bienvenidos! Consulta el flujo (fork → rama desde `dev` → PR) en [CONTRIBUTING.md](CONTRIBUTING.md). Todos los pull requests pasan automáticamente por CI de lint + smoke test. > [!IMPORTANT] > **CraftBot** se encuentra en desarrollo activo, con mejoras semanales. Si tienes dudas o quieres una conversación más rápida, únete a [Discord](https://discord.gg/ZN9YHc37HG) o escribe a thamyikfoong(at)craftos.net. --- ## 🧾 Licencia Este proyecto está bajo la [Licencia MIT](LICENSE). Puedes usarlo, hospedarlo y monetizarlo libremente (en caso de distribución o monetización, debes dar crédito a este proyecto). --- ## ⭐ Agradecimientos Desarrollado y mantenido por [CraftOS](https://craftos.net/) y sus colaboradores. Si **CraftBot** te resulta útil, ¡dale una ⭐ al repositorio y compártelo con otros! --- ## Historial de stars Star History Chart