forked from innovacion/playground
89 lines
1.9 KiB
Markdown
89 lines
1.9 KiB
Markdown
# 🚀 Inicio Rápido
|
|
|
|
## Pasos para ejecutar el proyecto:
|
|
|
|
### 1. Instalar dependencias
|
|
```bash
|
|
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):
|
|
```bash
|
|
cp .env.local.example .env.local
|
|
# Edita y descomenta GOOGLE_API_KEY
|
|
```
|
|
|
|
### 3. Ejecutar el proyecto
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
# 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
|