Skip to content

Guía de Instalación

Esta guía proporciona los pasos necesarios para configurar y ejecutar el proyecto completo (backend y frontend) en un entorno de desarrollo local.

Prerrequisitos

  • Python 3.9+
  • Node.js 16+ y npm
  • Git

1. Clonar el Repositorio

git clone https://github.com/Bootcamp-IA-P4/project-x-nlp-team-3.git
cd project-x-nlp-team-3

2. Configuración del Backend (server/)

El backend es una API de FastAPI que sirve el modelo de IA.

# 1. Navega a la carpeta del servidor
cd server/

# 2. Crea y activa un entorno virtual
python -m venv venv
source venv/bin/activate  # En Windows: venv\Scripts\activate

# 3. Instala las dependencias de Python
pip install -r requirements.txt

# 4. Configura las variables de entorno
# Crea un archivo llamado .env en la carpeta server/ y añade las siguientes claves:
# SUPABASE_URL=tu_url_de_supabase
# SUPABASE_KEY=tu_api_key_de_supabase
# YOUTUBE_API_KEY=tu_api_key_de_youtube

# 5. Inicia el servidor de desarrollo
uvicorn main:app --reload --port 8000

El backend estará ahora corriendo en http://localhost:8000.

3. Configuración del Frontend (client/)

El frontend es una aplicación de React construida con Vite.

# 1. Abre una nueva terminal y navega a la carpeta del cliente
cd client/

# 2. Instala las dependencias de Node.js
npm install

# 3. Inicia el servidor de desarrollo de Vite
npm run dev

El frontend estará ahora accesible en http://localhost:5173 (o el puerto que indique Vite).

4. (Opcional) Docker

El proyecto también puede ser levantado utilizando Docker y Docker Compose para una configuración más aislada y reproducible.

# Desde la raíz del proyecto
docker-compose up --build