Skip to content

QUICKSTART.md

Latest commit

 

History

History
163 lines (119 loc) · 3.35 KB

QUICKSTART.md

File metadata and controls

163 lines (119 loc) · 3.35 KB
Raw

🚀 Quick Start - Exposia

Guía rápida para tener Exposia funcionando en 10 minutos.

⚡ Inicio Rápido (Windows)

1️⃣ Clonar y Configurar (2 min)

# Ya estás en ExposiaClean/

2️⃣ Backend - Instalar y Configurar (2 min)

# Ir a backend
cd backend

# Instalar dependencias
npm install

# Copiar archivo de configuración
copy .env.example .env

# Editar .env con tus credenciales
notepad .env

Configurar .env:

SUPABASE_URL=https://tu-proyecto.supabase.co
SUPABASE_KEY=tu-anon-key
SUPABASE_SERVICE_KEY=tu-service-key
GROQ_API_KEY=tu-groq-api-key
DEEPGRAM_API_KEY=tu-deepgram-api-key
JWT_SECRET=cambia-esto-por-algo-seguro

3️⃣ Supabase - Configurar DB (2 min)

  1. Ve a https://supabase.com y crea un proyecto
  2. Copia tu URL y Keys
  3. Ve a SQL Editor
  4. Copia y ejecuta backend/src/infrastructure/database/supabase_schema.sql
  5. Ve a Storage y crea buckets: pdfs y audios (públicos)

4️⃣ Frontend - Instalar y Configurar (2 min)

# Abrir nueva terminal
cd frontend

# Instalar dependencias
npm install

# Copiar configuración
copy .env.example .env

# Editar .env
notepad .env

Configurar .env:

VITE_SUPABASE_URL=https://tu-proyecto.supabase.co
VITE_SUPABASE_ANON_KEY=tu-anon-key
VITE_API_URL=http://localhost:3000

5️⃣ Ejecutar (1 min)

Terminal 1 - Backend:

cd backend
npm run start:dev

Terminal 2 - Frontend:

cd frontend
npm run dev

6️⃣ ¡Listo! 🎉

Abre http://localhost:5173 en tu navegador.

🔑 Obtener API Keys Rápido

Groq (Gratis)

  1. https://console.groq.com
  2. Sign Up
  3. API Keys → Create
  4. Copiar

Deepgram (Gratis - $200 créditos)

  1. https://console.deepgram.com
  2. Sign Up
  3. API Keys → Create
  4. Copiar

Nota: Ya tienes una API key de Deepgram en el archivo .env.example

🧪 Probar que Funciona

Test Backend

# En una terminal
curl http://localhost:3000/api/v1

Debería responder: {"message":"Exposia API"}

Test Frontend

Abre http://localhost:5173 y deberías ver la página principal de Exposia.

📊 Arquitectura Rápida

Usuario → React Frontend → NestJS Backend → Supabase DB
                                          → Groq AI
                                          → Deepgram API

🎯 Próximos Pasos

  1. Lee el NESTJS_MIGRATION.md para entender la migración
  2. Revisa la ARCHITECTURE.md para entender el diseño
  3. Sube tu primer PDF de prueba
  4. Graba un audio de prueba
  5. ¡Analiza tu presentación!

🆘 Problemas Comunes

Error: No module named 'X'

pip install -r requirements.txt

Error: Cannot connect to Supabase

  • Verifica las credenciales en .env
  • Asegúrate de haber ejecutado el SQL schema

Error: Puerto en uso

# Cambiar puerto del backend en main.py
# Cambiar puerto del frontend en vite.config.ts

Error: PowerShell Execution Policy

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

💡 Tips

  • Usa el tier gratuito de Groq primero
  • Supabase free tier es suficiente para desarrollo
  • La documentación de la API está en http://localhost:8000/docs
  • Usa React DevTools para debugging del frontend

¡Disfruta construyendo con Exposia! 🚀