De un prompt a producción
en menos de 90 segundos.
Agente autónomo que genera sitios web estáticos completos y los despliega automáticamente con Groq AI, GitHub y Cloudflare Pages.
$ python webgen.py "landing page para cafetería artesanal" ╔══════════════════════════════════════════════════╗ ║ 🚀 WebGen · MolvicStudios Ecosystem ║ ╚══════════════════════════════════════════════════╝ 🤖 Generando código con Groq (llama-3.3-70b)... ✅ Código generado: Cafetería Artesanal La Taza 📦 Creando repositorio en GitHub... ✅ cafeteria-artesanal-la-taza → github.com/usuario/... ✓ index.html ✓ style.css ✓ README.md ☁️ Conectando con Cloudflare Pages... ✅ Proyecto creado · deploy automático activado ⏳ Esperando despliegue ████████████████ 100% ✅ ¡Sitio desplegado y funcionando! 🌐 https://cafeteria-artesanal-la-taza.pages.dev ⏱ Tiempo total: 47 segundos
Características
Integración completa del ciclo de vida de un sitio web.
Usa Groq + llama-3.3-70b para crear HTML, CSS y JS completo desde una descripción en lenguaje natural. Sin plantillas rígidas.
Crea el repositorio, sube todos los archivos y configura la rama main lista para deploy, sin tocar la interfaz de GitHub.
Conecta el repo con Cloudflare Pages y genera la URL pública. HTTPS automático, CDN global y zero-config.
Tailwind CSS vía CDN, responsive y mobile-first. Paleta de colores coherente al tipo de negocio sin configuración manual.
HTML5 semántico, CSS3 y JavaScript puro ES6+. Sin frameworks, sin bundlers, sin dependencias. Carga instantánea en cualquier hosting.
Credenciales en .env local nunca expuestas. HTTPS automático. Repos públicos por defecto, cambiables a privados.
Flujo de trabajo
5 pasos completamente automáticos.
Tu prompt viaja a la API de Groq. llama-3.3-70b-versatile responde con un JSON estructurado que contiene index.html, y opcionalmente style.css y script.js solo cuando son necesarios. Tiempo: ~5-15s.
Usa la GitHub API (PyGithub) para crear el repo en tu cuenta con nombre en kebab-case generado automáticamente por la IA. Sube todos los archivos más un README.md. Tiempo: ~5-10s.
Llama a la API de Cloudflare para crear el proyecto de Pages apuntando al repo de GitHub, con deploy automático en cada push a main. Tiempo: ~3-5s.
Polling automático cada 5 segundos (máx. 12 intentos = 60s) hasta que el sitio responde con HTTP 200. Primer deploy de Cloudflare suele tardar 30-60s.
Recibes la URL pública https://tu-proyecto.pages.dev lista para compartir. Tiempo total típico: 30–90 segundos.
Instalación
6 distros de Linux y Windows 10/11. Selecciona tu sistema.
$ sudo apt update && sudo apt install -y python3 python3-pip python3-venv git
$ git clone https://github.com/molvicstudios/webgen.git && cd webgen $ bash install.sh
$ nano .env # pega tus API keys $ python webgen.py "landing page para tu negocio"
✓ Probado en Ubuntu 20.04 · 22.04 · 24.04 LTS, Debian 11/12, Linux Mint, Pop!_OS
# .env GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx # github.com/settings/tokens → permiso repo GITHUB_USERNAME=tu-usuario GROQ_API_KEY=gsk_xxxxxxxxxxxxxxxxxxxx # console.groq.com/keys CLOUDFLARE_API_TOKEN=xxxxxxxxxxxxxxxxxxxx # dash.cloudflare.com → API Tokens CLOUDFLARE_ACCOUNT_ID=xxxxxxxxxxxxxxxxxxxx # barra lateral del dashboard
GitHub Token
Settings → Developer settings → Personal access tokens (classic) → permiso repo
Groq API Key
console.groq.com/keys → Create API Key. Plan gratuito incluye ~14.400 tokens/min.
Cloudflare
dash.cloudflare.com → Profile → API Tokens → template "Edit Cloudflare Pages"
Prompt Builder
Rellena los campos y copia el comando listo para usar.
$ python webgen.py "landing page para ..."
Ejemplos
Haz clic en cualquier tarjeta para copiar el comando completo.
Calidad del código
Código limpio, semántico y listo para producción.
📁 tu-proyecto/ ├── index.html # Siempre presente — página principal completa ├── style.css # Solo si se necesita CSS custom más allá de Tailwind ├── script.js # Solo si el sitio requiere interactividad JS └── README.md # Documentación básica generada automáticamente
Roadmap
Todo lo implementado y lo que viene.
Generación de sitios estáticos con IA
v1.0 — HTML, CSS, JS vanilla desde prompt en lenguaje natural
Deploy automático GitHub + Cloudflare Pages
v1.0 — Repo + URL pública en un solo comando, < 90 segundos
Instalador universal multiplataforma
v1.0 — install.sh para 6 distros Linux · install.ps1 para Windows 10/11
Templates predefinidos --template
v2.0 — landing · blog · portfolio · corporate · ecommerce
Modo actualización --update
v2.0 — Modifica sites existentes desde un nuevo prompt, push automático
Sitios multi-página --pages
v2.0 — Múltiples rutas HTML con navegación compartida
Dominio personalizado automático --domain
v2.0 — Asigna tu propio dominio vía API Cloudflare en el mismo comando
Analytics integrado --analytics
v2.0 — Cloudflare Analytics inyectado automáticamente en todos los HTML
Chatbot de soporte técnico
v2.0 — Asistente IA en tiempo real vía Groq · proxy seguro con Cloudflare Worker
Generación de imágenes con IA
Hero images generadas con DALL-E 3 / Stable Diffusion
Publicación en PyPI
pipx install webgen-molvic · instalación universal sin clonar el repo
FAQ
Por defecto se crea como público, necesario para Cloudflare Pages en el plan gratuito. Puedes cambiarlo a privado manualmente desde GitHub después del deploy si lo necesitas.
WebGen mostrará un error claro. Tienes dos opciones: (1) eliminar el repo existente desde GitHub, o (2) modificar ligeramente el prompt para que la IA genere un nombre diferente.
Sí. Si el paso de Cloudflare falla o no tienes cuenta, el repositorio de GitHub se crea igualmente con el código completo. Puedes desplegarlo manualmente en Cloudflare Pages, Vercel, Netlify o GitHub Pages sin problema.
WebGen en sí es gratuito. El coste viene de las APIs: Groq tiene plan gratuito generoso (~14.400 tokens/min), GitHub es gratis para repos públicos, y Cloudflare Pages incluye 500 deploys/mes en el plan gratuito.
El primer despliegue suele tardar entre 30 y 90 segundos. Si pasados 5 minutos el sitio no responde, revisa el dashboard de Cloudflare Pages para ver el estado y posibles errores en los logs.
Por supuesto. El repo queda en tu GitHub y puedes editar los archivos libremente. Cada push a main dispara un nuevo deploy automático en Cloudflare Pages, por lo que los cambios se reflejan en producción en segundos.
Arch y sistemas similares implementan PEP 668 que impide instalar paquetes pip globalmente para proteger el sistema. Usa la pestaña "Manual" en la sección de instalación para crear un venv. Incluimos el .venv/ ya creado en el repo.
WebGen Assistant
Soporte técnico · llama-3.3-70b