forjabot

Chatbots de IA para tu negocio, desde tu terminal. forjabot instala y mantiene bots de IA por giro (restaurante, barbería, inmobiliaria, clínica…) en tu propia cuenta de Cloudflare, con tus llaves. El bot es tuyo — para usarlo o revenderlo.

Pensado para que lo maneje tu agente de IA (Claude Code o Codex): tú respondes preguntas de negocio y apruebas; el agente corre lo técnico.

Parte de Forja, la plataforma de chatbots de Horizontes IA.

Instalación

No necesitas instalar nada global. Se corre con npx:

npx forjabot init

Requisitos:

• Node 18+ (para npx).
• Una cuenta gratis de Cloudflare (ahí vive tu bot).
• Un agente de IA — Claude Code o Codex — para ejecutar los pasos.
• Una llave de IA (Anthropic, OpenAI o xAI). Se guarda como secreto de Cloudflare, nunca en el CLI.

Inicio rápido

# 1 · asistente: elige idioma, licencia (gratis o Forja+) y giro
npx forjabot init

# 2 · verifica que todo esté sano
npx forjabot doctor

# 3 · mantente al día cuando saquemos mejoras (sin perder tu configuración)
npx forjabot update

init baja la plantilla del giro que elijas y te hace unas preguntas del negocio. Al terminar, tu agente despliega el bot a Cloudflare y tú abres tu panel en https://<tu-worker>.workers.dev/admin.

Tu agente aprende a usar Forja

La primera vez, forjabot instala una guía para tu agente en ~/.claude/skills/forja/ (Claude Code). Con eso tu agente sabe cómo usar el CLI y el flujo completo: instalar, configurar, desplegar y operar el bot. Puedes desactivarlo con --no-agent-skill o la variable FORJA_NO_AGENT_SKILL=1.

Comandos

| Comando | Qué hace | |---|---| | forjabot init | Asistente interactivo: idioma (ES/EN), licencia (gratis con tu correo o key HZN-…), elige el giro e instala. | | forjabot list | Muestra el catálogo de bots disponibles para tu plan. | | forjabot install <slug> | Instala un giro específico (p. ej. restaurante, barberia, inmobiliaria). | | forjabot update [carpeta] | Trae la versión nueva conservando tu member/ (config, base de conocimiento). | | forjabot doctor [carpeta] | Diagnóstico del bot instalado: versión, archivos, licencia y si el worker responde. |

Opciones útiles:

• --key HZN-XXXX-XXXX-XXXX — pasa tu licencia de Forja+ sin el asistente (install / update / init).
• --email [email protected] --name "Tu Nombre" — para el arranque gratis sin teclear (útil si tu teclado no mete la @ en la terminal).
• Todo el onboarding acepta flags (pensado para que tu agente lo corra sin menús): --giro --negocio --que --ofrece --horario --ubicacion --telefono --web --pagos --faq --reglas --tono --cerebro --yes.

El asistente usa menús con flechas (↑/↓ + enter). Si corres en un entorno sin terminal interactiva (CI, scripts), cae automáticamente a listas numeradas.

¿No tienes licencia de Forja+? La obtienes al entrar a la comunidad de Horizontes IA (horizontesia.com): ahí recibes tu llave HZN-….

La licencia y el idioma se guardan en ~/.forja/config.json. La versión instalada vive en el marcador .horizontes-bot.json dentro de la carpeta de tu bot.

Los comandos del agente

Una vez instalado, operas el bot pidiéndole skills a tu agente (no son subcomandos de forjabot, son instrucciones que tu agente ejecuta sobre el bot ya instalado):

• reporte — informe mensual de valor para tu cliente. (Gratis)
• exportar — llévate tus leads y conversaciones. (Gratis)
• mantenimiento, afinar, campaña, clonar, precios — operación recurrente. (Forja+)
• Modo Agencia: cliente-nuevo, cotizar, propuesta, cobrar — para revender. (Forja+)

Le hablas normal a tu agente ("hazme el reporte del mes") y él sabe cuál usar.

Planes

• Gratis — instala el bot Starter, captura leads, panel básico. Se obtiene con tu correo.
• Forja + — los 14 giros con sus paneles, los comandos recurrentes y el Modo Agencia. Se activa con una key HZN-…. → Únete a Forja +

La licencia se hace cumplir en la distribución: sin licencia activa no bajas bots premium ni actualizas. Tu bot instalado nunca se apaga por esto — sigue corriendo.

Documentación

Guía completa, referencia de comandos y conexiones: https://forjabots.com/docs/

Privacidad

forjabot corre en tu máquina. No sube tu código ni los datos de tus clientes a Horizontes: solo valida tu licencia y baja el bot desde el control plane. El bot y todos sus datos viven en tu Cloudflare, con tus llaves.

© Horizontes IA · horizontesia.com