RAGster

Instalación Paso a Paso en 5 minutos

Paso 1 de 4

1. Clonar el repositorio

Primero, clona el repositorio de RAGster y instala las dependencias:

git clone https://github.com/saptiva-ai/ragster.git
cd ragster
npm install
💡 Tip: Asegúrate de tener Node.js v18 o superior. Si no lo tienes, descárgalo aquí: https://nodejs.org/
Verifica tu versión con: node --version

2. Obtener Saptiva API Key

Sigue estos pasos para obtener tu API Key de Saptiva:

  1. Ir a https://lab.saptiva.com/
  2. Iniciar sesión con Google
  3. En el menú lateral, hacer clic en Crear API Key
  4. Hacer clic en el botón + Crear API Key
  5. Nombre: ragster
  6. Hacer clic en Crear API Key
  7. ⚠️ Copiar la API Key inmediatamente (no se podrá ver de nuevo)
Comienza con "va-ai-" seguido de caracteres alfanuméricos
⚠️ Importante: Guarda esta API Key en un lugar seguro. Una vez que cierres la ventana en lab.saptiva.com, no podrás verla de nuevo.

3. Obtener Weaviate Credentials

Configura tu base de datos vectorial con Weaviate:

  1. Ir a https://console.weaviate.cloud/
  2. Crear cuenta o iniciar sesión
  3. Hacer clic en Create cluster
  4. Seleccionar plan Free sandbox
  5. Nombre del cluster: ragster
  6. Hacer clic en Create
  7. ⏱️ Esperar 1-2 minutos mientras se crea el cluster
  8. Hacer clic en tu cluster → pestaña Details
  9. Copiar el REST Endpoint
  10. Ir a pestaña API Keys
  11. Crear API Key con nombre: ragster
  12. Copiar el Admin API Key
Ejemplo: https://ragster-xxx.weaviate.network
Cadena alfanumérica larga
💡 Tip: El cluster gratuito de Weaviate se desactiva después de 14 días de inactividad.

4. Instalar MongoDB Local

Descargar e instalar MongoDB Community Server:

  1. Ir a https://www.mongodb.com/try/download/community
  2. Descargar MongoDB Community Server
  3. Instalar (marcar "Install as a Service")
  4. MongoDB se inicia automáticamente
✓ Valores automáticos de MongoDB:
Estos valores ya están configurados por defecto para localhost.

Para visualizar tu base de datos (opcional):

💡 Descarga MongoDB Compass para ver tus datos visualmente:
https://www.mongodb.com/try/download/compass
Conecta con: mongodb://localhost:27017
Para DB con autenticación: mongodb://username:password@localhost:27017

5. Revisar y Generar .env.local

Revisa tu configuración antes de generar el archivo:

Saptiva API Key
No configurado
Weaviate Host
No configurado
Weaviate API Key
No configurado
MongoDB URI
mongodb://localhost:27017
NextAuth Secret
••••••••••••••••