Dokumentation

Installation

Resume Matcher ohne Docker aus dem Quellcode starten: Python 3.13+ und uv für das Backend, Node.js 22+ und npm für das Frontend, jeweils im eigenen Terminal.

Voraussetzungen

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

Installiere uv mit:

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

Lokale Entwicklungsumgebung einrichten

Klone das Haupt-Repo der Resume-Matcher-App und starte dann Backend und Frontend in getrennten Terminals.

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

Lokale Standard-URLs

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

Das Frontend erwartet das Backend standardmäßig unter http://127.0.0.1:8000.

Resume Matcher finanziert sich über Spenden.

Mehr als 200.000 Jobsuchende haben es genutzt, kostenlos, ohne Werbung und ohne Bezahlschranke. Wenn es dir Zeit gespart oder zu einem Vorstellungsgespräch verholfen hat, sorgt ein Sponsoring oder ein spendierter Kaffee dafür, dass es so bleibt.

Auf GitHub sponsern Spendier mir einen Kaffee Stern auf GitHub28k+

Playwright für den PDF-Export

Die PDF-Erzeugung nutzt Playwright und Chromium. Wenn die Backend-Abhängigkeiten installiert sind, führe aus:

cd apps/backend
uv run playwright install chromium

Ohne diesen Schritt funktioniert der PDF-Export nur, wenn Chrome oder Edge auf dem Rechner installiert ist; darauf greift die App dann zurück.

Der PDF-Export braucht außerdem ein laufendes Frontend, weil Chromium die Druckseite des Frontends druckt.

Hinweise

  • npm install in apps/frontend installiert nur die Frontend-Abhängigkeiten.
  • In der lokalen Entwicklung werden Frontend und Backend getrennt gestartet.
  • Richte deinen KI-Anbieter unter http://localhost:3000/settings ein, sobald beide Server laufen.
  • Deine Daten landen in einer SQLite-Datenbank in apps/backend/data/, die keine Einrichtung braucht. Wenn du stattdessen PostgreSQL nutzen willst, siehe PostgreSQL statt SQLite verwenden (auf Englisch).
  • Unterstützt werden unter anderem OpenAI, Anthropic, OpenRouter, Google Gemini, DeepSeek, Groq, Azure AI Foundry, Ollama und OpenAI-kompatible Server, dazu dein ChatGPT- oder Claude-Abo. Siehe Eigenen KI-Schlüssel verwenden.

Fehlerbehebung

uv wird nicht gefunden

Installiere es mit:

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

Falsche Python-Version

Prüfe:

python --version

Die lokale Entwicklung von Resume Matcher erfordert Python 3.13+.

Das Frontend erreicht die API nicht

Stelle sicher, dass das Backend unter http://127.0.0.1:8000 läuft.

Der PDF-Export schlägt fehl

Stelle sicher, dass das Frontend läuft, und führe dann in apps/backend erneut aus:

uv run playwright install chromium

Nächste Schritte

Zurück zur Dokumentation