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 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.
English | 日本語 | 简体中文 | 繁體中文 | 한국어 | Português | Français | Deutsch
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.
- Living UI. 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
/newa 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. Base de conocimiento local construida a partir de tu interacción con CraftBot mediante RAG + sistema de archivos del agente + destilación. 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 con Google Workspace, Slack, Notion, Zoom, LinkedIn, Discord y Telegram (¡y vienen más!), con credenciales embebidas y soporte para OAuth.
- 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.
- Multiplataforma. Compatibilidad completa con Windows, macOS y Linux, con variantes de código específicas por plataforma y contenedorización Docker.
- 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.
- Bring Your Own Key (BYOK) — Sistema flexible de proveedores de LLM con soporte para OpenAI, Google Gemini, Anthropic Claude, BytePlus y modelos locales de Ollama. Cambia entre proveedores fácilmente.
- Sistema de Memoria — Destila y consolida los eventos del día cada medianoche.
- Agente Proactivo — Aprende tus preferencias, hábitos y metas de vida. Luego planifica e inicia tareas (con tu aprobación, por supuesto) para ayudarte a mejorar en la vida.
- Living UI — Crea, importa o evoluciona aplicaciones personalizadas que viven dentro de CraftBot. El agente es consciente del estado de la UI y puede leer, escribir y actuar sobre sus datos directamente.
- Integración con herramientas externas — Conéctate a Google Workspace, Slack, Notion, Zoom, LinkedIn, Discord y Telegram (¡vendrán más!) con credenciales integradas y soporte OAuth.
- MCP — Integración con Model Context Protocol para ampliar las capacidades del agente con herramientas y servicios externos.
- Skills — Framework de skills extensible con skills integradas para planificación de tareas, investigación, revisión de código, operaciones de git y más.
- Multiplataforma — Soporte completo para Windows, macOS y Linux con variantes de código específicas por plataforma y contenedorización con Docker.
Important
El modo GUI está obsoleto. CraftBot ya no admite el modo GUI (automatización de escritorio). Usa en su lugar el modo Browser o CLI.
Requisitos: Python 3.10+ · Node.js 18+ para el modo navegador
# 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 installEso 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:
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 paquetesTip
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.
Living UI es un sistema/app/dashboard que evoluciona con tus necesidades.
- ¿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?
# 1. Clona el repositorio
git clone https://github.com/CraftOS-dev/CraftBot.git
cd CraftBot
# 2. Instala en un entorno conda
python install.py --conda
# 3. Ejecuta CraftBot
conda run -n craftbot python run.py
# Si conda no está en PATH (solo Windows):
&"$env:USERPROFILE\miniconda3\Scripts\conda.exe" run -n craftbot python run.pyNote
Cada vez que quieras ejecutar CraftBot, usa conda run -n craftbot python run.py. No hay servicio en segundo plano — lo inicias y detienes tú mismo.
Elige esta si: quieres control total sobre tu entorno Python y prefieres gestionar CraftBot tú mismo, sin servicio automático ni proceso en segundo plano.
install.py (sin opciones) hace una instalación pip estándar en el entorno Python activo. Inicias y detienes CraftBot manualmente con run.py.
# 1. Clona el repositorio
git clone https://github.com/CraftOS-dev/CraftBot.git
cd CraftBot
# 2. Instala las dependencias en tu entorno Python activo
python install.py
# 3. Ejecuta CraftBot
python run.pyLa primera ejecución te guiará para configurar tus claves API y preferencias.
Note
Si Node.js no está instalado, el instalador te ofrecerá instrucciones paso a paso. También puedes omitir completamente el modo navegador y usar el modo CLI — sin Node.js: python run.py --cli
- Hablar con el agente de forma natural
- Pedirle que realice tareas complejas de varios pasos
- Escribir
/helppara ver los comandos disponibles - Conectarte a Google, Slack, Notion y más
CraftBot soporta varios modos de UI. Elige según tu preferencia:
| Modo | Comando | Requisitos | Recomendado para |
|---|---|---|---|
| Browser | python run.py |
Node.js 18+ | Interfaz web moderna, la más sencilla de usar |
| CLI | python run.py --cli |
Ninguno | Línea de comandos, ligero |
El modo navegador es el predeterminado y recomendado. Si no tienes Node.js, el instalador te ofrecerá instrucciones de instalación o puedes usar el modo CLI en su lugar.
Living UI es un sistema/app/panel que evoluciona con tus necesidades.
¿Necesitas un tablero kanban con un copiloto de IA integrado? ¿Un CRM personalizado que se ajuste exactamente a tu flujo de trabajo? ¿Un panel de empresa que CraftBot pueda leer y manejar por ti? Pon uno en marcha como Living UI: se ejecuta junto a CraftBot y crece a medida que cambian tus necesidades.
- 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.
- Instalar desde el marketplace. Explora las Living UIs creadas por la comunidad en living-ui-marketplace.
- 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 Living UI.
Una Living UI 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 Living UI 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.
Construye, personaliza y haz evolucionar tu propia Living UI, y depende menos de herramientas por suscripción que nunca se diseñaron para encajar perfectamente con tus necesidades.
Estamos buscando activamente desarrolladores que muestren sus Living UIs y las exporten al marketplace de Living UI. ¡Los PRs son bienvenidos!
- 📋 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.
| Componente | Descripción |
|---|---|
| Agent Base | Capa de orquestación central que gestiona el ciclo de vida de las tareas, coordina los componentes y maneja el bucle agente principal. |
| LLM Interface | Interfaz unificada que soporta múltiples proveedores LLM (OpenAI, Gemini, Anthropic, BytePlus, Ollama). |
| Context Engine | Genera prompts optimizados con soporte de KV-cache. |
| Action Manager | Recupera y ejecuta acciones desde la biblioteca. Las acciones personalizadas son fáciles de extender. |
| Action Router | Selecciona inteligentemente la acción que mejor se ajusta a los requisitos de la tarea y resuelve los parámetros de entrada mediante el LLM cuando es necesario. |
| Event Stream | Sistema de publicación de eventos en tiempo real para seguimiento del progreso de tareas, actualizaciones de UI y monitoreo de ejecución. |
| Memory Manager | Memoria semántica basada en RAG con ChromaDB. Gestiona fragmentación de memoria, embeddings, recuperación y actualizaciones incrementales. |
| State Manager | Gestión global del estado para rastrear el contexto de ejecución del agente, el historial de conversación y la configuración en tiempo de ejecución. |
| Task Manager | Administra definiciones de tareas, habilita modos de tareas simples y complejas, crea todos y hace seguimiento a flujos de trabajo multietapa. |
| Skill Manager | Carga e inyecta skills intercambiables en el contexto del agente. |
| MCP Adapter | Integración con Model Context Protocol que convierte herramientas MCP en acciones nativas. |
| v0 / Lovable / Bolt | OpenClaw | Claude Code | CraftBot | |
|---|---|---|---|---|
| Construye apps personalizadas | ✅ De un tirón | 🚫 | ✅ (manual) | ✅ Conversacional |
| El agente opera la app | 🚫 | 🚫 | ✅ Embebido en cada Living UI | |
| Memoria persistente del agente | 🚫 | ✅ | ✅ | ✅ RAG + sistema de archivos del agente + destilación |
| Autohospedable | ✅ | 🚫 SaaS | ✅ MIT, en tu propia máquina | |
| Independiente del modelo | ✅ | ✅ | ✅ Principales proveedores + OpenRouter |
| Flag | Descripción |
|---|---|
--conda |
Usa entorno conda (opcional) |
| Flag | Descripción |
|---|---|
| (ninguno) | Ejecutar en modo Browser (recomendado, requiere Node.js) |
--cli |
Ejecutar en modo CLI (ligero) |
| Comando | Descripción |
|---|---|
install |
Instala dependencias, registra el autoarranque e inicia CraftBot |
start |
Inicia CraftBot en segundo plano |
stop |
Detiene CraftBot |
restart |
Detener y luego iniciar |
status |
Muestra el estado de ejecución y del autoarranque |
logs [-n N] |
Muestra las últimas N líneas de log (por defecto: 50) |
uninstall |
Elimina el registro de autoarranque |
Ejemplos de instalación:
# Instalación simple con pip (sin conda)
python install.py
# Con entorno conda (recomendado para usuarios de conda)
python install.py --condaEjecución de CraftBot:
# Modo navegador (por defecto, requiere Node.js)
python run.py
# Modo CLI (ligero)
python run.py --cli
# Con entorno conda
conda run -n craftbot python run.py
# O usando la ruta completa si conda no está en PATH
&"$env:USERPROFILE\miniconda3\Scripts\conda.exe" run -n craftbot python run.pyLinux/macOS (Bash):
# Modo navegador (por defecto, requiere Node.js)
python run.py
# Modo CLI (ligero)
python run.py --cli
# Con entorno conda
conda run -n craftbot python run.pyEjecuta CraftBot como un servicio en segundo plano para que siga funcionando incluso después de cerrar la terminal. Se crea automáticamente un acceso directo en el escritorio para reabrir el navegador cuando quieras.
# Instala dependencias, registra autoarranque al iniciar sesión e inicia CraftBot
python craftbot.py installEso es todo. La terminal se cierra sola, CraftBot se ejecuta en segundo plano y el navegador se abre automáticamente.
# Otros comandos del servicio:
python craftbot.py start # Inicia CraftBot en segundo plano
python craftbot.py status # Comprueba si está en ejecución
python craftbot.py stop # Detiene CraftBot
python craftbot.py restart # Reinicia CraftBot
python craftbot.py logs # Ver el log reciente| Comando | Descripción |
|---|---|
python craftbot.py install |
Instala dependencias, registra autoarranque al iniciar sesión, inicia CraftBot, abre el navegador y cierra la terminal automáticamente |
python craftbot.py start |
Inicia CraftBot en segundo plano — se reinicia automáticamente si ya está en ejecución (la terminal se cierra sola) |
python craftbot.py stop |
Detiene CraftBot |
python craftbot.py restart |
Detiene e inicia CraftBot |
python craftbot.py status |
Comprueba si CraftBot está en ejecución y si el autoarranque está habilitado |
python craftbot.py logs |
Muestra la salida reciente del log (-n 100 para más líneas) |
python craftbot.py uninstall |
Detiene CraftBot, elimina el registro de autoarranque, desinstala paquetes pip y purga la caché de pip |
Tip
Tras craftbot.py start o craftbot.py install, se crea automáticamente un acceso directo de CraftBot en el escritorio. Si cierras el navegador por error, haz doble clic en el acceso directo para reabrirlo.
Note
Instalación: El instalador ahora ofrece orientación clara si faltan dependencias. Si no se encuentra Node.js, se te pedirá instalarlo o podrás cambiar al modo CLI. La instalación detecta automáticamente la disponibilidad de GPU y recurre al modo solo CPU si es necesario.
Tip
Configuración inicial: CraftBot te guiará por una secuencia de onboarding para configurar claves API, el nombre del agente, MCPs y Skills.
Note
Playwright Chromium: Opcional para la integración con WhatsApp Web. Si falla la instalación, el agente seguirá funcionando para otras tareas. Puedes instalarlo manualmente más tarde con: playwright install chromium
Si al ejecutar python run.py ves "npm not found in PATH":
- Descarga la versión LTS desde nodejs.org
- Instálala y reinicia la terminal
- Vuelve a ejecutar
python run.py
Alternativa: Usa el modo CLI (no necesita Node.js):
python run.py --cliEl 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 pipy vuelve a intentarlo
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.
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 environment.yml/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.
Desde la raíz del repositorio:
docker build -t craftbot .La imagen está configurada para lanzar el agente con python -m app.main por defecto. Para ejecutarlo de forma interactiva:
docker run --rm -it craftbotSi necesitas pasar variables de entorno, usa un archivo env (por ejemplo, basado en .env.example):
docker run --rm -it --env-file .env craftbotMonta 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 environment.yml/requirements.txt, así que python -m app.main funciona sin más.
¡Los PRs son bienvenidos! Consulta el flujo (fork → rama desde dev → PR) en 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 o escribe a thamyikfoong(at)craftos.net.
Este proyecto está bajo la Licencia MIT. Puedes usarlo, hospedarlo y monetizarlo libremente (en caso de distribución o monetización, debes dar crédito a este proyecto).
Desarrollado y mantenido por CraftOS y sus colaboradores. Si CraftBot te resulta útil, dale una ⭐ al repositorio y compártelo.