Atiende a tus clientes 24/7, responde desde tu base de conocimiento, y te avisa a ti cuando algo lo amerita. Vive en tu cuenta de Cloudflare, con tu llave de IA. Tus datos son tuyos. Sin mensualidades de SaaS.
Self-hosted, open-source AI support bot for small businesses. Lives in your Cloudflare, uses your AI key. Spanish-first. Deploy in minutes.
Instalar · Cómo funciona · Forja+ · Comunidad
Un asistente de soporte con IA que montas en tu propia infraestructura de Cloudflare en una tarde — sin saber programar. En lugar de pagar una mensualidad a un SaaS que se queda con tus conversaciones, Forja vive en tu cuenta, con tu llave de IA, y todo es tuyo.
- 💬 Multicanal — WhatsApp, Instagram, Messenger y Telegram desde un mismo cerebro.
- 📚 Aprende de tus documentos — subes tus FAQ, políticas y guías; el bot busca ahí antes de responder (RAG con base vectorial).
- 🎙️ Entiende notas de voz — transcribe los audios de tus clientes automáticamente.
- 🙋 Sabe cuándo pedir ayuda — si algo es delicado o no está seguro, te hace handoff a ti.
- 📊 Panel de administración — conversaciones, leads, base de conocimiento y métricas, todo en
/admin. - ☁️ Vive en tu Cloudflare — rápido, barato y sin servidores que mantener.
- 🧠 Tu cerebro, tu llave — Claude, ChatGPT o Grok; tú eliges y pagas solo lo que piensa.
No necesitas saber programar. Forja se instala y configura con Claude Code como tu copiloto — él corre los comandos por ti, paso a paso.
Abre Claude Code en tu terminal y dile:
ármame un chatbot con Forja
Claude te explica cómo funciona y cuánto cuesta, verifica que tengas lo necesario, y monta todo por ti: crea tu Cloudflare, despliega el bot y te entrega tu panel vivo. Por debajo corre:
npx forjabot initgit clone https://github.com/santmun/forja mi-chatbot
cd mi-chatbot
pnpm install
# Configura wrangler.toml (tu nombre de worker) y tus secretos
npx wrangler d1 create horizontes_bot_db # → pega el database_id en wrangler.toml
npx wrangler secret put ANTHROPIC_API_KEY # (o OPENAI/XAI)
npx wrangler secret put DASHBOARD_PASSWORD
pnpm db:apply:remote
pnpm run deployTu panel queda en https://<tu-worker>.workers.dev/admin.
Forja es gratis y open source. Lo único que pagas es tu propia infraestructura, y arranca casi en cero:
| Pieza | Costo | Notas |
|---|---|---|
| Cloudflare (la casa del bot) | $0 para empezar · ~$5/mes ya con tráfico real | D1, Vectorize y R2 tienen capa gratis generosa |
| Cerebro de IA (tu llave) | ~$1–2/mes para un negocio normal | Pagas solo lo que el bot piensa; tu llave, cifrada en tu Cloudflare |
Nadie más toca tus datos ni tus conversaciones.
flowchart LR
C["Cliente<br/>(WhatsApp / IG / Telegram)"] -->|mensaje| W["Forja<br/>Cloudflare Worker"]
W --> A["Agente (Durable Object)<br/>buffer + tools"]
A -->|busca contexto| V[("Vectorize<br/>base de conocimiento")]
A -->|piensa| LLM["Tu IA<br/>Claude / GPT / Grok"]
A -->|guarda| D[("D1<br/>conversaciones + leads")]
A -->|responde| C
A -.->|si algo lo amerita| O["Handoff al dueño"]
W --- P["Panel /admin<br/>conversaciones · leads · KB · métricas"]
Un mensaje entra por un canal → el agente arma contexto desde tu base de conocimiento → tu IA redacta la respuesta con la voz de tu negocio → se responde y se guarda. Si algo es delicado, te avisa a ti.
- Cloudflare Workers (Hono) — el runtime del bot.
- Vercel AI SDK — capa de LLM (Anthropic / OpenAI / xAI, con llave propia).
- D1 (SQLite) — conversaciones, leads, configuración.
- Vectorize (bge-m3) — base de conocimiento / RAG.
- R2 — media (imágenes, audios).
- Durable Objects — el agente que piensa y responde (buffer + tools).
Todo en el ecosistema de Cloudflare: un solo pnpm run deploy y está en línea.
El Starter de este repo sirve para cualquier negocio. Si quieres ir más allá, Forja+ (con la comunidad de Horizontes IA) desbloquea:
- 🎯 14 giros con panel a la medida — barbería, restaurante, inmobiliaria, clínica, spa, gimnasio, hotelería y más, cada uno con sus herramientas (reservaciones, agenda, calificar prospectos…).
- 🤖 Comandos que trabajan por ti —
/mantenimiento,/campaña,/afinar,/clonar(arma tu KB desde tu web),/precios… - 💼 Modo Agencia — arma y revende bots a otros negocios, con cotizador y propuesta incluidos.
- 👥 Comunidad + soporte — 600+ personas construyendo con IA en español, y actualizaciones gestionadas.
Nadie más que tú. Forja corre en TU cuenta de Cloudflare con TUS llaves: las conversaciones de tus clientes viven en tu base de datos y el bot no envía telemetría ni datos de uso a Horizontes IA ni a nadie. No hay ping de activación ni analíticas ocultas — puedes revisarlo tú mismo en src/.
- Los mensajes se borran solos a los 90 días (cron diario). Los leads y tickets se quedan hasta que tú los borres.
- No se guardan audios ni imágenes: se transcriben o describen y solo queda el texto.
- Los links del bot cuentan clics, sin IP ni navegador.
- El texto de la conversación sí viaja al proveedor de IA que tú elegiste (con tu llave) para poder responder.
- Si preguntan si es un bot, el bot lo admite. No lo configures para negarlo.
Como dueño del negocio, tú eres el responsable de esos datos: avisa a tus clientes que la atención es automatizada y que guardas la conversación, y atiende las solicitudes de borrado. Todo el detalle está en PRIVACY.md.
Los PRs son bienvenidos. Lee CONTRIBUTING.md para el flujo, y abre un issue si tienes una idea o encuentras un bug. Este repo es el Starter open source; los giros y comandos de Forja+ viven aparte.
MIT © Horizontes IA. Úsalo, modifícalo y móntalo para quien quieras.
Hecho con 🔨 por Horizontes IA · YouTube · Comunidad