Requisitos previos
- Python 3.13+
- Node.js 22+
- uv
- npm
Instala uv con:
curl -LsSf https://astral.sh/uv/install.sh | shConfiguració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 devURL 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.
Resume Matcher se sostiene con donaciones.
Más de 200.000 personas que buscan empleo lo han usado, gratis, sin anuncios ni muro de pago. Si te ahorró tiempo o te ayudó a conseguir una entrevista, patrocinar o invitarme un café lo mantiene así.
Playwright, necesario para exportar PDF
La generación de PDF usa Playwright y Chromium. Después de instalar las dependencias del backend, ejecuta:
cd apps/backend
uv run playwright install chromiumSin este paso, la exportación a PDF solo funciona si Chrome o Edge están instalados en el equipo, ya que la aplicación los usa como alternativa.
La exportación a PDF también necesita el frontend en marcha, porque Chromium imprime la página de impresión del frontend.
Notas
npm installenapps/frontendinstala solo las dependencias del frontend.- En desarrollo local, el frontend y el backend se arrancan por separado.
- Configura tu proveedor de IA en
http://localhost:3000/settingscuando los dos servidores estén en marcha. - Tus datos van a una base de datos SQLite en
apps/backend/data/, que no necesita configuración. Para usar PostgreSQL en su lugar, consulta Usar PostgreSQL en lugar de SQLite. - Los proveedores compatibles incluyen OpenAI, Anthropic, OpenRouter, Google Gemini, DeepSeek, Groq, Azure AI Foundry, Ollama y servidores compatibles con OpenAI, además de tu plan de ChatGPT o de Claude. 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 | shVersión de Python incorrecta
Comprueba:
python --versionEl 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
Asegúrate de que el frontend está en marcha y vuelve a ejecutar desde apps/backend:
uv run playwright install chromium