Planeador de Sociales
Página web con un asistente de IA que prepara planes de clase de Ciencias Sociales para Colombia. Usa como estrategia el análisis de fuentes históricas y cartográficas y respeta los referentes del MEN sin inventar citas.
- Código: se guarda en GitHub.
- Página pública: se publica gratis en Vercel, conectado a GitHub. Cada cambio que se suba a GitHub se publica solo.
- IA: por ahora Gemini de Google (gratis). Ya está preparada para pasar a Claude (de pago) cuando se quiera. La clave de la IA queda guardada en Vercel y nunca llega al navegador.
- Acceso: solo entra quien tenga un código de acceso. Se puede dar un código distinto a cada persona.
¿Por qué no solo GitHub Pages? GitHub Pages solo sirve páginas estáticas. Allí la clave de la IA quedaría visible para cualquiera que abra la página. Vercel ejecuta la parte del servidor que esconde la clave.
Paso a paso (una sola vez)
1. Cuenta de GitHub ✅
Ya creada.
2. Clave gratis de Gemini (Google AI Studio)
- Entre a https://aistudio.google.com/apikey con una cuenta de Google.
- Si el correo de la U de Caldas no lo deja entrar (algunas universidades bloquean AI Studio), use un Gmail personal.
- Acepte los términos si se los pide.
- Pulse Create API key (Crear clave de API). Si le pregunta por un proyecto, elija el que trae por defecto o cree uno nuevo.
- Copie la clave (empieza por
AIza…) y guárdela en un lugar seguro. No la envíe por chat ni por correo.
No pide tarjeta. El nivel gratuito tiene un límite de solicitudes por minuto y por día, suficiente para unas pocas personas. En el nivel gratuito, Google puede usar las conversaciones para mejorar sus productos: no escriba datos personales de estudiantes.
3. Subir el código a GitHub
Lo hace Claude con usted conectada a GitHub. Se crea un repositorio privado llamado chatbot-sociales.
4. Cuenta de Vercel y publicación
- Entre a https://vercel.com/signup y elija Hobby. Pulse Continue with GitHub y autorice.
- Add New → Project → importe
chatbot-sociales.
- Antes de pulsar Deploy, abra Environment Variables y agregue:
| Nombre | Valor |
|---|
GEMINI_API_KEY | la clave copiada en el paso 2 |
CODIGOS_ACCESO | los códigos separados por coma, ej.: maria-7341,juan-2290,ana-5512 |
- Pulse Deploy. Al terminar, Vercel muestra la dirección de la página (ej.:
https://chatbot-sociales.vercel.app).
5. Compartir
Envíe a cada persona la dirección y su código. Para quitarle el acceso a alguien, borre su código en Vercel (Settings → Environment Variables) y pulse Redeploy.
Pasar a Claude más adelante (opcional, de pago)
- Cree la cuenta en https://platform.claude.com (elija Individual), cargue crédito en Billing (mínimo US$5) y cree una clave en API Keys.
- En Vercel, agregue
ANTHROPIC_API_KEY con esa clave y borre GEMINI_API_KEY. Pulse Redeploy.
- Modelo por defecto:
claude-opus-5-5 (unos US$0,10 a US$0,25 por plan). Para gastar menos, agregue MODELO con claude-haiku-5-5 (menos de US$0,01 por plan) o claude-sonnet-5-5.
Cambiar el comportamiento del asistente
Las instrucciones (el filtro de temas, la estructura del plan y las reglas sobre DBA y estándares) están en lib/instrucciones.js. Sirven igual para Gemini y para Claude.
Probar en el computador (opcional)
Requiere Node.js 20 o superior.
npm install
npm run local
Abra http://localhost:3000. Sin archivo .env funciona en modo demostración (código prueba, respuesta de ejemplo). Para usar la IA de verdad, copie .env.example como .env y llene la clave.
Archivos
| Archivo | Para qué sirve |
|---|
index.html | La página: ingreso con código, formulario, chat, copiar y descargar para Word |
api/chat.js | Servidor: valida el código y elige la IA |
lib/gemini.js | Conexión con Gemini (gratis) |
lib/claude.js | Conexión con Claude (de pago) |
lib/instrucciones.js | Instrucciones del asistente |
dev-server.js | Servidor de prueba local |
vercel.json | Da hasta 5 minutos por respuesta |
