Documentazione

Installazione

Avviare Resume Matcher dal codice sorgente senza Docker: Python 3.13+ e uv per il backend, Node.js 22+ e npm per il frontend, ciascuno nel proprio terminale.

Prerequisiti

  • Python 3.13+
  • Node.js 22+
  • uv
  • npm

Installa uv con:

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

Configurare l’ambiente di sviluppo locale

Clona il repository principale dell’app Resume Matcher, poi avvia backend e frontend in due terminali separati.

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 locali predefiniti

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

Per impostazione predefinita, il frontend si aspetta il backend su http://127.0.0.1:8000.

Resume Matcher vive di donazioni.

Più di 200.000 persone in cerca di lavoro l'hanno usato, gratis, senza pubblicità e senza paywall. Se ti ha fatto risparmiare tempo o ti ha aiutato a ottenere un colloquio, una sponsorizzazione o un caffè offerto lo mantengono così.

Sponsorizza su GitHub Offrimi un caffè Stella su GitHub28k+

Playwright, necessario per l’esportazione in PDF

La generazione dei PDF usa Playwright e Chromium. Dopo aver installato le dipendenze del backend, esegui:

cd apps/backend
uv run playwright install chromium

Senza questo passaggio, l’esportazione in PDF funziona solo se sulla macchina sono installati Chrome o Edge, che l’app usa al loro posto.

L’esportazione in PDF richiede anche che il frontend sia in esecuzione, perché Chromium stampa la pagina di stampa del frontend.

Note

  • npm install in apps/frontend installa solo le dipendenze del frontend.
  • Nello sviluppo locale, frontend e backend si avviano separatamente.
  • Configura il tuo fornitore di IA su http://localhost:3000/settings quando entrambi i server sono in esecuzione.
  • I tuoi dati finiscono in un database SQLite in apps/backend/data/, che non richiede configurazione. Per usare PostgreSQL al suo posto, vedi Usare PostgreSQL invece di SQLite (in inglese).
  • I fornitori supportati includono OpenAI, Anthropic, OpenRouter, Google Gemini, DeepSeek, Groq, Azure AI Foundry, Ollama e i server compatibili con OpenAI, oltre al tuo abbonamento ChatGPT o Claude. Vedi Usa la tua chiave IA.

Risoluzione dei problemi

uv non trovato

Installalo con:

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

Versione di Python sbagliata

Controlla:

python --version

Lo sviluppo locale di Resume Matcher richiede Python 3.13+.

Il frontend non raggiunge l’API

Assicurati che il backend sia in esecuzione su http://127.0.0.1:8000.

L’esportazione in PDF non funziona

Assicurati che il frontend sia in esecuzione, poi esegui di nuovo da apps/backend:

uv run playwright install chromium

Prossimi passi

Torna alla documentazione