ATS Resume Improver: darmowy optymalizator CV oparty na AI
Table of Contents
Darmowe, open source i możliwe do samodzielnego hostowania. Twoje CV nie trafia na serwer, chyba że używasz dostawcy AI. Nawet wtedy tekst trafia bezpośrednio do dostawcy AI, a nie do nas.
Czym jest ATS Resume Improver?
ATS Resume Improver to przeglądarkowy optymalizator CV typu open source. Analizuje CV w odniesieniu do oferty pracy i pomaga zmniejszyć różnicę między Twoim doświadczeniem a tym, co oceniają systemy śledzenia kandydatów (ATS). Narzędzie zbudowano w React 19, Vite i TypeScript. Cały proces parsowania i oceniania działa w przeglądarce, bez serwera backendowego.
Kod źródłowy znajdziesz pod adresem repozytorium ATS Resume Improver w GitHub . Możesz skorzystać z hostowanej wersji, wdrożyć własną na Vercel/Netlify/Cloudflare/GitHub Pages jednym kliknięciem albo uruchomić ją lokalnie w Dockerze.
Rozwiązanie problemu prywatności
Większość usług optymalizacji CV przesyła dokument na własny serwer, wykonuje zastrzeżoną ocenę i przechowuje dane. ATS Resume Improver działa inaczej.
| Tryb | Dane opuszczające Twoje urządzenie |
|---|---|
| Bez klucza AI | Żadne. Wszystko działa lokalnie w przeglądarce. |
| OpenAI / Anthropic | Tekst CV i oferta pracy trafiają bezpośrednio do API dostawcy AI z użyciem Twojego klucza. Bez serwera pośredniczącego. |
| Ollama (lokalnie) | Żadne. Model działa na Twoim komputerze. |
Klucze API są przechowywane tylko w pamięci i znikają po zamknięciu karty. Bez analityki, śledzenia i plików cookie.
Główne funkcje
Co działa bez klucza AI
Klucz API nie jest potrzebny, by skorzystać z narzędzia. Tryb bez klucza obejmuje:
- Przesyłanie CV: PDF, DOCX, TXT lub Markdown
- Ekstrakcja tekstu ATS: pokazuje dokładnie, co system ATS odczytuje z pliku, także utratę formatowania
- Wykrywanie typu CV: automatycznie rozpoznaje, który z 7 profili pasuje do Twojego CV, i odpowiednio zmienia kolejność sekcji
- Wykrywanie sekcji i ostrzeżenia o formatowaniu: wskazuje brakujące sekcje i formaty utrudniające pracę parserów
- Wynik ATS (0–100) z podziałem na 5 wymiarów
- Analiza luk słów kluczowych: porównanie oparte na regułach z opisem stanowiska
- Deterministyczna optymalizacja ATS: lokalne porządkowanie według reguł
- Porównanie przed i po zmianach: dokładny podgląd wprowadzonych zmian
- Profesjonalny eksport do PDF, DOCX, TXT i Markdown
Co daje AI
Połącz OpenAI, Anthropic Claude lub lokalną Ollamę, a narzędzie zyska dodatkowe funkcje:
- Semantyczna analiza słów kluczowych: rozumie kontekst, a nie tylko zgodność ciągów znaków. Pokazuje siłę dopasowania (silne/umiarkowane/częściowe), miejsce dopasowania (“znaleziono w umiejętnościach i 3 rolach”), wagę słowa (krytyczne/wysokie/średnie/niskie) oraz 2–3-zdaniowe podsumowanie AI
- Optymalizacja CV przez AI: pełne przepisanie przy użyciu promptów zgodnych z dobrymi praktykami ATS
- Eksport ulepszony przez AI: AI formatuje plik PDF/DOCX przed pobraniem
- Generowanie listu motywacyjnego: reguły językowe usuwają charakterystyczne oznaki tekstu AI (szczegóły poniżej)
- Przewidywanie pytań na rozmowie: na podstawie oferty pracy
- Szacowanie przedziału wynagrodzenia
Wykrywanie typu CV
Aplikacja automatycznie klasyfikuje CV do jednego z 7 profili i dostosowuje kolejność sekcji do oczekiwań rekruterów i systemów ATS na danym etapie kariery:
| Profil | Odpowiedni dla | Priorytet sekcji |
|---|---|---|
| 🏢 Doświadczony specjalista | Ponad 5 lat, liniowa ścieżka kariery | Doświadczenie → Umiejętności → Wykształcenie |
| 🌱 Poziom średni | 2–5 lat | Doświadczenie → Umiejętności → Wykształcenie |
| 🎓 Początkujący | 0–2 lata | Umiejętności → Wykształcenie → Projekty → Doświadczenie |
| 🎒 Student / świeżo po studiach | Nadal studiuje | Wykształcenie → Projekty → Umiejętności → Doświadczenie |
| 🔬 Pracownik naukowy / badacz | Doktorat, publikacje | Wykształcenie → Badania → Publikacje → Doświadczenie |
| 📜 Liczne certyfikaty | Certyfikaty ważniejsze niż dyplom | Certyfikaty → Umiejętności → Doświadczenie → Wykształcenie |
| 🔄 Zmiana kariery | Wykryta przerwa lub zmiana ścieżki | Podsumowanie → Umiejętności transferowalne → Wykształcenie → Doświadczenie |
Kolejność sekcji pozostaje taka sama podczas optymalizacji oraz eksportu do PDF, DOCX, TXT i Markdown, a nie tylko na ekranie.
Semantyczna analiza słów kluczowych przez AI
To wyróżnia narzędzie na tle prostych liczników słów kluczowych. Po skonfigurowaniu dostawcy AI analiza luk przechodzi od prostego porównywania ciągów znaków do rozumowania semantycznego:
| Wymiar | Bez AI | Z AI |
|---|---|---|
| Metoda dopasowania | Tylko dokładna zgodność tekstu | Semantyczne rozumienie kontekstu |
| Siła dopasowania | — | Ocena silna / umiarkowana / częściowa |
| Kontekst dopasowania | — | “znaleziono w umiejętnościach i 3 rolach” |
| Waga luki | Wszystkie luki mają taką samą wagę | Krytyczna / wysoka / średnia / niska |
| Sugestie | Ogólne wskazówki | Konkretne sugestie dla każdego słowa |
| Pokrycie % | Liczba zgodnych ciągów | Waga semantyczna |
| Podsumowanie | — | 2–3-zdaniowa narracja AI |
Lokalna analiza oparta na regułach działa natychmiast. AI uzupełnia ją asynchronicznie, gdy przeglądasz wyniki.
Obsługiwani dostawcy AI
Każde wywołanie AI zawiera prompty zgodne z dobrymi praktykami ATS, opracowanymi na podstawie wytycznych Harvard OCS i Columbia CCE.
OpenAI
| Nazwa modelu | Zastosowanie |
|---|---|
| GPT-4.1 mini (domyślny) | Inteligentny, szybki i przystępny cenowo, zalecany |
| GPT-4o mini | Klasyczna szybka i przystępna opcja |
| GPT-4.1 | Najnowszy GPT-4.1, dobrze wykonuje instrukcje |
| GPT-4o | Wysoka jakość, flagowy model |
| GPT-4 Turbo | Duże okno kontekstu |
| GPT-3.5 Turbo | Najszybszy i najtańszy |
Szacowany koszt: około 0,002–0,05 USD za analizę CV.
Anthropic Claude
| Nazwa modelu | Zastosowanie |
|---|---|
| Claude Sonnet 4.5 (domyślny) | Szybki i inteligentny, zalecany |
| Claude Opus 4.5 | Najbardziej zaawansowany, dobry do złożonych zadań |
| Claude Haiku 4.5 | Najszybszy i najtańszy |
| Claude 3.5 Sonnet | Niezawodny i dobrze sprawdzony |
| Claude 3.5 Haiku | Szybki i przystępny cenowo model v3.5 |
Ollama (lokalnie / na własnym serwerze)
Klucz API nie jest wymagany. Uruchom model na własnym sprzęcie. Ustaw OLLAMA_ORIGINS=*, aby zezwolić przeglądarce na dostęp.
| Nazwa modelu | Uwagi |
|---|---|
| Llama 3.3 (domyślny) | Najnowszy Meta Llama, zalecany |
| Llama 3.2 | Meta Llama 3.2 |
| Mistral 7B | Szybki i wszechstronny |
| Mixtral 8x7B | Model typu mixture of experts |
| Qwen 2.5 | Alibaba Qwen 2.5 |
| DeepSeek R1 | Zaawansowane rozumowanie |
| Phi-4 | Microsoft Phi-4 |
| Gemma 3 | Google Gemma 3 |
Uruchomienie Ollamy lokalnie pozwala używać całego narzędzia offline. Żadne dane nie opuszczają komputera.
Naturalnie brzmiące listy motywacyjne
Generator listów motywacyjnych stosuje celowy poradnik stylu, by usunąć charakterystyczne oznaki tekstu wygenerowanego przez AI. Reguły inspirowane są ramami humanizacji tekstu AI autorstwa Sabriny Ramonov . Każdy wygenerowany list spełnia następujące zasady:
- Bez em dashy: najmocniejszy sygnał AI jest całkowicie usuwany
- Ponad 50 zakazanych słów i zwrotów: leverage, utilize, dive deep, delve, embark, game-changer, groundbreaking, cutting-edge, pivotal, tapestry, harness, moreover, in conclusion, it’s worth noting, ever-evolving, landscape, testament, not only…but also i inne
- Bez Markdown w treści listu: bez pogrubień oznaczonych gwiazdkami, hashtagów i średników
- Domyślnie strona czynna: strona bierna tylko wtedy, gdy wykonawca naprawdę nie ma znaczenia
- Wymagane skrócone formy: “I’ve”, “I’m”, “it’s”, nigdy “I have”, “I am”, “it is”
- Zróżnicowana długość zdań: krótkie, konkretne zdania przeplatają się z dłuższymi
- Bez pustych wstępów: “It’s important to note that X” zamienia się na samo “X”
- Konkretny szczegół z oferty w pierwszym akapicie: pokazuje, że list nie pochodzi z szablonu
Wynik brzmi jak tekst człowieka, bo reguły wymuszają taki styl.
Jakość eksportu
| Format | Zawartość |
|---|---|
| Profesjonalna typografia, linie oddzielające sekcje, wypunktowania i dane kontaktowe | |
| DOCX | Prawidłowo ułożony dokument Word (Packer.toBlob, zgodny z przeglądarką) |
| TXT | Czysty tekst z równymi odstępami, bezpieczny dla ATS |
| Markdown | Ustrukturyzowany .md z nagłówkami i listami |
Po skonfigurowaniu dostawcy AI eksport jest formatowany przez AI przed pobraniem i oznaczony plakietką ✨ AI-Enhanced.
Własny hosting
Wersja hostowana (bez konfiguracji)
Użyj aplikacji pod adresem wersja online ATS Resume Improver . Nie potrzebujesz konta, rejestracji ani karty kredytowej.
Wdrożenie w chmurze jednym kliknięciem
| Platforma | Link |
|---|---|
| Vercel | Wdrożenie repozytorium jednym kliknięciem |
| Cloudflare Pages | Wdrożenie jednym kliknięciem |
| Netlify | Wdrożenie jednym kliknięciem |
| GitHub Pages | Fork → Settings → Pages → GitHub Actions → automatyczne wdrożenie |
Programowanie lokalne
git clone https://github.com/simeononsecurity/ats-resume-improver
cd ats-resume-improver
make install
make dev # http://localhost:5173
Docker (zalecany dla odtwarzalnych środowisk)
# Programowanie: automatyczne odświeżanie pod http://localhost:5173
make docker-dev
# Produkcja: nginx pod http://localhost:8080
make docker-prod
# Programowanie i Ollama razem (pełny lokalny stos AI)
make docker-dev-with-ollama
Ollama całkowicie offline
# Uruchom kontener Ollama (modele pozostają po ponownym uruchomieniu)
make ollama
# Pobierz model
make ollama-pull MODEL=llama3.2
# Uruchom aplikację deweloperską i Ollama równolegle
make docker-dev-with-ollama
Otwórz aplikację, przejdź do panelu kluczy API, wybierz Ollama (Local), ustaw adres http://localhost:11434 i wybierz model. Żadne dane nie opuszczają komputera.
Stos technologiczny
| Warstwa | Technologia |
|---|---|
| Framework | React 19 + TypeScript |
| Kompilacja | Vite 8 |
| Stylizacja | Tailwind CSS v4 |
| Ikony | Lucide React |
| Parser PDF | pdfjs-dist |
| Parser DOCX | mammoth |
| Eksport PDF | jsPDF |
| Eksport DOCX | docx (Packer.toBlob) |
| AI | OpenAI · Anthropic Claude · Ollama |
| Kontener | Docker + nginx (multi-stage) + usługa Ollama |
Cały proces analizowania i oceniania (atsAnalyzer.ts, keywordMatcher.ts, resumeTypeDetector.ts) działa w przeglądarce. Integracje AI w aiProvider.ts wywołują API dostawców bezpośrednio z klienta. Nie ma serwera proxy.
Praktyczny przewodnik
Krok 1: Prześlij CV
Prześlij plik PDF, DOCX, TXT lub Markdown. Otwórz kartę “What the ATS Sees”, aby sprawdzić, czy parser poprawnie odczytał treść. Jeśli w tym widoku brakuje sekcji albo są uszkodzone, oprogramowanie ATS rekruterów będzie miało ten sam problem.
Krok 2: Wklej opis stanowiska
Wklej pełną ofertę pracy do panelu Job Description. Pełniejsza oferta daje lepszą analizę słów kluczowych, więc nie skracaj sekcji wymagań.
Krok 3: Sprawdź wynik ATS
Panel pokazuje wynik 0–100 oraz podział na 5 wymiarów. Podział wskazuje, na czym się skupić: problemy z formatem obniżają jeden wymiar, brakujące słowa kluczowe inny, a słabe opisy obowiązków jeszcze inny.
Krok 4: Sprawdź luki słów kluczowych
Widok Keyword Analysis pokazuje, które słowa z oferty występują w CV, a których brakuje. Po włączeniu AI otrzymasz dopasowanie semantyczne i ocenę ważności. Luka “Critical” w kluczowej umiejętności technicznej wymaga większej uwagi niż luka “Low” dotycząca ogólnego hasła o umiejętnościach miękkich.
Krok 5: Zoptymalizuj
- Tryb deterministyczny: przebudowuje strukturę według reguł. Jest bezpieczny, szybki i nie powoduje kosztów API.
- Tryb AI: pełne przepisanie przez LLM przy użyciu promptów zgodnych z dobrymi praktykami ATS.
Przejrzyj porównanie przed i po zmianach, aby zrozumieć każdą zmianę przed jej zaakceptowaniem.
Krok 6: Eksportuj
Eksportuj do PDF, DOCX, TXT lub Markdown. Po włączeniu AI eksport jest formatowany z myślą o profesjonalnej prezentacji. Szablon PDF używa odpowiedniej typografii i układu znanego rekruterom.
Integracja porad dotyczących CV
Do narzędzia dołączono materiał RESUME_TIPS.md (dostępny też w repozytorium GitHub), który opisuje:
- Jak systemy ATS oceniają CV
- Które reguły formatowania mają znaczenie i co psuje parsery
- Jak pisać skuteczne podsumowania, punkty i sekcje umiejętności
- Strategię słów kluczowych bez ich upychania
- Ton i strukturę listu motywacyjnego
- Listę kontrolną przed wysłaniem
Przeczytaj go przed użyciem narzędzia, aby wiedzieć, co oznaczają wyniki.
Często zadawane pytania
Czy narzędzie zapisuje moje CV?
Nie. Aplikacja działa całkowicie po stronie klienta. Żadne dane nie są zapisywane na serwerze. Dane sesji znajdują się w pamięci przeglądarki i znikają po zamknięciu karty.
Mój wynik jest niski. Czy mam się martwić?
Wyniki ATS wskazują kierunek, a nie zaliczenie lub porażkę. Wynik 60 nie oznacza, że system ATS Cię odrzuci. Pokazuje mierzalne różnice między Twoim CV a konkretną przeanalizowaną ofertą. Użyj wyniku, aby ustalić kolejność zmian, a nie jako werdyktu.
Czy mogę używać narzędzia z wieloma ofertami pracy?
Tak. W dowolnym momencie wklej nową ofertę. Analiza słów kluczowych i optymalizacja zostaną uruchomione ponownie dla nowego stanowiska. Każda analiza jest niezależna.
Czy integracja Ollama naprawdę działa offline?
Tak, jeśli Ollama działa na Twoim komputerze lub komputerze w sieci lokalnej. Aplikacja wysyła tekst przez HTTP do Twojej instancji Ollama. Żadne dane nie trafiają do usług zewnętrznych.
Jak dokładne jest wykrywanie typu CV?
Detektor stosuje heurystyki oparte na regułach i analizuje treść CV: wspomniane lata doświadczenia, oznaki wykształcenia, sekcje publikacji lub badań oraz sygnały przerw w karierze. Dobrze działa dla większości CV, ale może się pomylić w nietypowych przypadkach. Zastosowaną kolejność sekcji zawsze można zmienić.
Plan rozwoju projektu
Funkcje w trakcie tworzenia lub planowane:
- Historia wersji CV przez IndexedDB
- Optymalizator profilu LinkedIn
- Obsługa Google Gemini
- Dodatkowe modele Ollama
Projekt jest objęty licencją MIT i przyjmuje pull requesty. Przed większymi zmianami najpierw otwórz issue.
Podsumowanie
ATS Resume Improver wypełnia istotną lukę: oferuje poważną analizę CV bez przekazywania danych pośrednikom. Tryb bez klucza natychmiast daje konkretne wskazówki dotyczące formatowania i pokrycia słów kluczowych. Dodanie klucza AI rozszerza analizę o rozumowanie semantyczne, pisanie listów motywacyjnych i przygotowanie do rozmów. Kosztuje to grosze za analizę albo jest całkowicie darmowe z Ollamą.
Hostowana wersja działa pod adresem wersja online ATS Resume Improver . Pełny kod źródłowy znajdziesz na repozytorium ATS Resume Improver w GitHub .
Jeśli hostujesz narzędzie na własnym serwerze do szukania pracy albo chcesz dostosować wagi i prompty dla konkretnej branży, konfigurację Dockera i przejrzystą strukturę projektu łatwo rozwidlić i zmodyfikować.
Kurs optymalizacji CV
Jeśli chcesz skorzystać z uporządkowanego przewodnika po tym, co ocenia narzędzie, przeczytaj kurs uzupełniający:
Kurs optymalizacji CV: pokonaj systemy ATS i zdobądź więcej rozmów — 9 modułów obejmujących punktację ATS, formatowanie, wypunktowania, słowa kluczowe, dopasowanie CV, listy motywacyjne i checklistę przed wysłaniem. Używaj narzędzia razem z kursem, aby otrzymywać natychmiastową informację zwrotną na każdym etapie.
Źródła
- narzędzie online
- repozytorium kodu źródłowego
- Porady dotyczące CV — RESUME_TIPS.md
- Sabrina Ramonov — najlepszy prompt AI do nadawania tekstowi ludzkiego brzmienia
- dokumentacja API OpenAI
- dokumentacja API Anthropic Claude
- Ollama — lokalny serwer LLM