Che cos'è Resume Matcher?

Resume Matcher è uno strumento (un «harness») di IA gratuito e open source per adattare il CV: lo esegui sul tuo computer, colleghi il modello di IA che già usi e lui riscrive il tuo CV per ogni annuncio di lavoro. Funziona con il modello che scegli, come Claude, ChatGPT, Gemini, DeepSeek o un modello locale tramite Ollama. Tiene i tuoi dati in un database locale ed esporta CV puliti in PDF a partire da modelli adatti agli ATS (i sistemi di gestione delle candidature). Controlli nel codice impediscono all’IA di cambiare i tuoi datori di lavoro o le tue date, o di aggiungere numeri che non sono nell’originale. Lo usano più di 200.000 persone in cerca di lavoro, ed è distribuito con licenza Apache 2.0.

Una nota sui termini: in inglese il curriculum si chiama «resume» (o «CV»), da cui il nome. L’interfaccia dell’app non esiste in italiano, e l’italiano non si può impostare come lingua in cui scrive l’IA; le lingue disponibili sono elencate più sotto. Per candidature in inglese, per esempio presso aziende internazionali o all’estero, lo strumento è adatto così com’è.

Cos’è, e cosa non è

È:

• Un’app open source (Apache 2.0) che scarichi ed esegui tu, sul tuo portatile o in Docker.
• Uno strumento in cui «porti la tua IA». Colleghi un LLM (un modello linguistico di grandi dimensioni, il tipo di IA dietro Claude o ChatGPT), e Resume Matcher si occupa di prompt, controlli e formattazione.
• Uno strumento per adattare il CV. Prende il tuo CV principale e un annuncio di lavoro e produce una versione mirata a quell’annuncio.
• Un editor di CV con sette modelli pronti per la stampa e l’esportazione in PDF.
• Un piccolo spazio di lavoro per la ricerca di lavoro, con lettere di presentazione, messaggi di contatto, preparazione ai colloqui e una bacheca Kanban per le candidature.

Non è:

• Un sito su cui caricare il tuo CV. Non esiste una versione ospitata; lo esegui tu.
• Un simulatore di ATS. (Un ATS, o sistema di gestione delle candidature, è il software che i datori di lavoro usano per raccogliere e filtrare le candidature.) Il suo ATS Check verifica se il testo si rilegge in modo pulito dal suo stesso PDF, e i suoi punteggi sono confronti tra parole chiave. Nessuno di questi è un test contro un vero ATS.
• Un modello di IA. Colleghi il tuo: un fornitore cloud a pagamento o un modello locale gratuito.
• Un sito di annunci o un bot che si candida da solo. Non invia candidature da nessuna parte.
• Uno strumento che scrive un CV dal nulla. Lavora con i fatti che gli dai, cioè il CV che carichi o le tue risposte al suo assistente, che funziona come un colloquio.

A chi si rivolge

Agli sviluppatori e a chi usa già Claude o ChatGPT. Se sai clonare un repository GitHub ed eseguire qualche comando nel terminale, o un solo comando Docker, puoi farlo girare con la tua chiave API o un modello locale. Modello, costi e dati restano sotto il tuo controllo.

A chi cerca lavoro in ruoli tecnici. Ingegneri, designer, professionisti dei dati e product manager tecnici che si candidano a molte posizioni e vogliono per ognuna una versione onesta e distinta del proprio CV, senza incollare ogni volta la propria storia in un chatbot.

Non a chi vuole un sito web. Se vuoi aprire una scheda del browser, caricare un file e ottenere un risultato senza installare nulla, Resume Matcher non è fatto per questo. Lo installi (Docker, oppure Python e Node.js) e colleghi un modello di IA.

Come funziona in 5 passaggi

1. Aggiungi il tuo CV principale. Carica un file PDF o Word (fino a 4 MB), oppure crealo rispondendo alle domande del Resume Wizard. Questo CV completo e non adattato è il tuo CV principale. Puoi tenerne fino a cinque, uno per ogni direzione di carriera.
2. Incolla un annuncio di lavoro. L’IA lo legge ed estrae le competenze richieste, quelle preferite e i termini chiave.
3. Controlla la bozza adattata. L’IA propone modifiche precise al tuo profilo, ai punti elenco e alle competenze, con le parole stesse dell’annuncio. Poi il codice controlla ogni modifica: nome, contatti, datori di lavoro, ruoli, date e titoli di studio non possono cambiare, e ogni nuovo numero assente dall’originale viene annullato. Vedi un’anteprima prima/dopo, con le modifiche rischiose segnalate, e scegli Confirm & Save (conferma e salva) o Reject & Regenerate (rifiuta e rigenera).
4. Rifinisci e completa. Modifica qualsiasi cosa nell’editor, scegli uno dei sette modelli, regola caratteri, spaziature, margini e colori, riordina o nascondi le sezioni. Genera una lettera di presentazione, un messaggio di contatto e una preparazione al colloquio per lo stesso annuncio.
5. Scarica e segui. Esporta CV e lettera di presentazione in PDF. Ogni CV adattato salvato riceve anche una scheda sulla bacheca del tracker delle candidature.

Porta la tua IA

Resume Matcher non include un modello di IA. Ne colleghi uno dalla pagina delle impostazioni, o con qualche variabile d’ambiente.

Fornitori supportati: OpenAI (modelli di ChatGPT), Anthropic (Claude), Google Gemini, DeepSeek, OpenRouter, Groq, Azure AI Foundry, Ollama (uno strumento gratuito che esegue modelli aperti sul tuo computer) e qualsiasi server locale compatibile con OpenAI come llama.cpp, vLLM o LM Studio. Puoi anche usare un abbonamento ChatGPT o Claude che paghi già, tramite due opzioni sviluppate dalla community, ognuna con le sue avvertenze.

Puoi usare qualsiasi modello offerto dal tuo fornitore. Le impostazioni suggeriscono un modello predefinito per ciascuno, per esempio GPT-5 Nano (OpenAI), Claude Haiku 4.5 (Anthropic), Gemini 3 Flash (Google) e Gemma 3 4B (Ollama).

• Costi: Resume Matcher è gratuito. Con un fornitore cloud, paghi quel fornitore per il tuo uso dell’API, alle sue tariffe. Con Ollama o un altro server locale non ci sono costi per richiesta.
• Privacy: con un fornitore cloud, il tuo CV (compresi nome e contatti) e l’annuncio vengono inviati a quel fornitore quando usi una funzione di IA. Nulla va agli autori di Resume Matcher. Con un modello locale, il testo non lascia mai la tua macchina.

Gira sulla tua macchina

Cosa resta in locale: i tuoi CV, gli annunci, le versioni adattate e la bacheca del tracker (in un file di database SQLite, o in PostgreSQL se lo configuri), le tue impostazioni e le tue chiavi API, salvate cifrate. Tutto sta in un’unica cartella sul tuo computer, o in un volume Docker.

Cosa lascia la tua macchina: solo le richieste di IA che avvii tu, inviate al fornitore che hai scelto. Nell’app non c’è codice di analisi o di tracciamento. La libreria di IA scarica all’avvio un listino pubblico dei prezzi dei modelli; non contiene nessun tuo dato e, offline, usa una copia integrata.

Completamente offline: usa Ollama o un altro server di modelli locale, e il tuo CV, l’annuncio e ogni risposta dell’IA restano sul tuo computer. Internet ti serve solo per installare l’app e scaricare il modello.

Cosa ottieni

• Sette modelli di CV: Single Column, Two Column, Modern, Modern Two Column, LaTeX, Clean e Vivid, in A4 o US Letter, con margini, spaziature, dimensione del carattere, caratteri serif, sans-serif o monospazio, un colore d’accento su tre modelli e l’ordine delle sezioni con il trascinamento.
• PDF adatti agli ATS: ogni PDF viene stampato da testo vero tramite un browser Chrome senza interfaccia, quindi ogni parola si può selezionare e copiare. I titoli usano i tag corretti, le impaginazioni a due colonne mettono il contenuto principale per primo nell’ordine di lettura, e i PDF includono i caratteri Noto Sans per il testo in cinese, giapponese e coreano.
• Lettere di presentazione e messaggi di contatto: lettere brevi (100–150 parole, scaricabili in PDF) e messaggi di contatto di 70–100 parole per e-mail o LinkedIn, scritti a partire dal tuo CV per l’annuncio specifico.
• Preparazione al colloquio: analisi dell’adeguatezza al ruolo, domande probabili sul tuo CV e sui progetti, competenze mancanti su cui prepararti e punti da toccare.
• Punteggio di corrispondenza: la scheda JD Match mostra quale percentuale delle parole significative dell’annuncio compare anche nel tuo CV, e le evidenzia. È una semplice sovrapposizione di parole chiave calcolata dal codice, non il parere di un’IA né una previsione di come il sistema di un datore di lavoro ti classificherà. Al momento conta solo parole senza accenti (a–z), quindi è pensata per annunci in inglese.
• Tracker delle candidature: una bacheca Kanban con le colonne Saved, Applied, No Response, Response, Interview, Accepted e Rejected. Ogni CV adattato aggiunge una scheda sotto Applied.
• Sette lingue per l’interfaccia e i testi dell’IA: inglese, spagnolo, cinese (semplificato), giapponese, portoghese del Brasile, francese e coreano. L’italiano non è tra queste.

Per iniziare

La via più rapida (Docker):

docker run --name resume-matcher -p 3000:3000 -v resume-data:/app/backend/data ghcr.io/srbhr/resume-matcher:latest

La stessa immagine è su Docker Hub come srbhr/resume-matcher:latest. Apri http://localhost:3000/settings, scegli il tuo fornitore di IA, incolla la tua chiave API e fai clic su Test Connection. Usi Ollama sullo stesso computer? Imposta l’URL di Ollama su http://host.docker.internal:11434.

In locale (Python 3.13+, Node.js 22+ e uv): vedi Installazione. Per una configurazione privata con un modello locale, vedi Docker + Ollama (in inglese).

Usi un agente di programmazione? Il repository include istruzioni per gli agenti: file CLAUDE.md e una cartella docs/agent/ con una guida rapida. Claude Code legge CLAUDE.md automaticamente; con Codex o Cursor, indica all’agente docs/agent/quickstart.md e chiedigli di configurare il progetto.

Domande frequenti

Resume Matcher è un ATS checker? Non nel senso comune. Adatta il tuo CV a un annuncio; non simula un sistema di gestione delle candidature né prevede come uno di questi ti classificherà. Il suo ATS Check impagina il CV in PDF e rilegge il testo come farebbe un semplice estrattore di testo, così vedi se un software riesce a leggerlo. I suoi punteggi sono semplici euristiche: la percentuale del JD Match è una sovrapposizione di parole chiave, e il punteggio ATS pesa corrispondenza delle parole chiave, copertura delle competenze, corrispondenza del titolo, completezza delle sezioni e coerenza delle date. I suoi modelli producono PDF puliti, basati sul testo, che quei sistemi possono leggere.

Inventa cose? È costruito per non farlo. L’IA può solo riformulare i tuoi contenuti esistenti, e il codice controlla ogni modifica: nomi, contatti, datori di lavoro, ruoli, date e titoli di studio sono bloccati, e ogni nuovo numero assente dall’originale viene annullato. L’unica eccezione voluta sono le competenze: può aggiungere una competenza che l’annuncio chiede esplicitamente, e la segnala come modifica rischiosa così puoi rifiutarla.

Quale modello di IA dovrei usare? Quello a cui hai già accesso. Le impostazioni suggeriscono un modello predefinito per ogni fornitore, e Gemma 3 4B su Ollama è un’opzione locale gratuita. Non c’è un minimo ufficiale, ma i modelli molto piccoli possono faticare con il formato di modifica strutturato.

È gratuito? Sì. È open source con licenza Apache 2.0. Se colleghi un fornitore di IA cloud a pagamento, quel fornitore ti addebita il tuo utilizzo; con un modello locale non ci sono costi d’uso.

Il mio CV lascia il mio computer? Solo quando usi un fornitore di IA cloud, e in quel caso solo verso il fornitore che hai scelto. Con un modello locale come Ollama, nulla lascia la tua macchina.

Posso usarlo senza saper programmare? Non devi scrivere codice, ma devi eseguire un comando nel terminale: un comando Docker, o qualche comando di installazione per Python e Node.js. Dopo, tutto avviene nel browser.

Che cos’è un CV principale? Il tuo CV completo e non adattato, con tutta la tua esperienza, i progetti e le competenze in un unico posto. Resume Matcher ne ricava ogni versione adattata e non lo sovrascrive mai. Puoi tenere fino a cinque CV principali, per esempio uno per ogni direzione di carriera.

Cosa posso caricare e scaricare? Puoi caricare file PDF, DOC o DOCX fino a 4 MB, oppure creare un CV con il Resume Wizard. I PDF scansionati, fatti solo di immagini, non sono supportati. CV e lettera di presentazione si scaricano in PDF.

Sostieni il progetto

Resume Matcher è sviluppato in modo aperto da Saurabh Rai e dai contributori. Se ti è utile, dagli una stella su GitHub e segui il progetto su GitHub, X e LinkedIn.