playground/frontend/START.md

🚀 Inicio Rápido

Pasos para ejecutar el proyecto:

1. Instalar dependencias

npm install

2. Configuración (Automática)

✅ El proyecto usa automáticamente las credenciales del archivo bnt-ia-innovacion-new.json

No necesitas configurar nada adicional. El archivo JSON ya contiene todas las credenciales necesarias.

Si quieres usar una API key diferente (opcional):

cp .env.local.example .env.local
# Edita y descomenta GOOGLE_API_KEY

3. Ejecutar el proyecto

npm run dev

4. Abrir en el navegador

Abre http://localhost:3000

---

📝 Notas Importantes

Sobre la Autenticación

El proyecto usa Google Generative AI SDK (@google/generative-ai) con las credenciales del archivo bnt-ia-innovacion-new.json.

La autenticación es automática mediante google-auth-library que lee el Service Account del JSON.

Verificar que todo funciona

1. Abre http://localhost:3000
2. Selecciona un modelo (por defecto: gemini-2.0-flash-exp)
3. Escribe un prompt simple: "un gato naranja"
4. Haz clic en "Generar Imagen"

Si ves errores:

• Verifica que la API key sea válida
• Revisa los logs en la terminal
• Revisa la consola del navegador (F12)

---

🔧 Comandos útiles

# Desarrollo
npm run dev

# Build para producción
npm run build

# Ejecutar producción
npm start

# Linting
npm run lint

---

🐛 Problemas Comunes

Error: "API key not valid"

• Verifica que copiaste correctamente la API key
• Asegúrate de que el archivo .env.local existe
• Reinicia el servidor de desarrollo (Ctrl+C y npm run dev de nuevo)

Error: "Module not found"

• Ejecuta npm install de nuevo
• Borra node_modules y .next, luego npm install

Las imágenes no se generan

• Algunos modelos de Gemini aún no soportan generación de imágenes
• Prueba con diferentes prompts
• Revisa los logs del servidor para más detalles