Instalación | Resume Matcher

Requisitos previos

Python 3.13+
Node.js 22+
uv
npm

Instala uv con:

curl -LsSf https://astral.sh/uv/install.sh | sh

Configuración para desarrollo local

Clona el repo principal de la aplicación Resume Matcher y después arranca el backend y el frontend en terminales separadas.

git clone https://github.com/srbhr/Resume-Matcher.git
cd Resume-Matcher

# Terminal 1
cd apps/backend
cp .env.example .env
uv sync
uv run app

# Terminal 2
cd apps/frontend
npm install
npm run dev

URL locales por defecto

Frontend: http://localhost:3000
Backend: http://127.0.0.1:8000

El frontend espera el backend en http://127.0.0.1:8000 por defecto.

Playwright, necesario para exportar PDF

La generación de PDF depende de Playwright y Chromium. Después de instalar las dependencias del backend, ejecuta:

cd apps/backend
python -m playwright install chromium

Sin este paso, la exportación a PDF falla.

Notas

npm install en apps/frontend instala solo las dependencias del frontend.
En desarrollo local, el frontend y el backend se arrancan por separado.
Configura tu proveedor de IA en la aplicación cuando los dos servidores estén en marcha.
Los proveedores compatibles incluyen OpenAI, Anthropic, OpenRouter, Google Gemini, DeepSeek, Groq, Azure AI Foundry, Ollama y servidores compatibles con OpenAI. Consulta Usa tu propia clave de IA.

Solución de problemas

No se encuentra uv

Instálalo con:

curl -LsSf https://astral.sh/uv/install.sh | sh

Versión de Python incorrecta

Comprueba:

python --version

El desarrollo local de Resume Matcher requiere Python 3.13+.

El frontend no llega a la API

Asegúrate de que el backend está corriendo en http://127.0.0.1:8000.

La exportación a PDF falla

Vuelve a ejecutar:

python -m playwright install chromium