Installation | Resume Matcher

Prérequis

Python 3.13+
Node.js 22+
uv
npm

Installez uv avec :

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

Configurer l’environnement de développement local

Clonez le dépôt principal de l’application Resume Matcher, puis lancez le backend et le frontend dans deux terminaux séparés.

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 par défaut

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

Par défaut, le frontend s’attend à trouver le backend sur http://127.0.0.1:8000.

Playwright, nécessaire pour l’export PDF

La génération des PDF utilise Playwright et Chromium. Une fois les dépendances du backend installées, lancez :

cd apps/backend
uv run playwright install chromium

Sans cette étape, l’export PDF ne fonctionne que si Chrome ou Edge est installé sur la machine, car l’application s’en sert alors à la place.

L’export PDF a aussi besoin que le frontend tourne, parce que Chromium imprime la page d’impression du frontend.

Remarques

npm install dans apps/frontend n’installe que les dépendances du frontend.
En développement local, le frontend et le backend se lancent séparément.
Configurez votre fournisseur d’IA sur http://localhost:3000/settings une fois les deux serveurs lancés.
Vos données sont enregistrées dans une base SQLite située dans apps/backend/data/, qui ne demande aucune configuration. Pour utiliser PostgreSQL à la place, consultez Utiliser PostgreSQL au lieu de SQLite (en anglais).
Les fournisseurs pris en charge comprennent OpenAI, Anthropic, OpenRouter, Google Gemini, DeepSeek, Groq, Azure AI Foundry, Ollama et les serveurs compatibles OpenAI, ainsi que votre forfait ChatGPT ou Claude. Consultez Utiliser votre propre clé d’IA.

Dépannage

uv est introuvable

Installez-le avec :

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

Mauvaise version de Python

Vérifiez :

python --version

Le développement local de Resume Matcher nécessite Python 3.13+.

Le frontend n’arrive pas à joindre l’API

Vérifiez que le backend tourne bien sur http://127.0.0.1:8000.

L’export PDF échoue

Vérifiez que le frontend tourne, puis relancez depuis apps/backend :

uv run playwright install chromium