-
-
Notifications
You must be signed in to change notification settings - Fork 1
FAQ
Nein! PBP ist ein eigenstaendiges Verwaltungstool, das auch komplett ohne KI funktioniert. Ohne Claude kannst du:
- Bewerbungen verwalten (erstellen, Status tracken, Timeline fuehren)
- Dokumente organisieren (hochladen, verknuepfen, durchsuchen)
- Termine planen (Kalender mit Kategorien, .ics-Export)
- E-Mails importieren (automatische Zuordnung, Status-Erkennung)
- Statistiken auswerten (Charts, Conversion-Rates, Trends)
- Follow-ups tracken (Erinnerungen, Fristen)
- Stellenangebote durchsuchen (35 Jobportale konfiguriert, ~6 liefern aktuell zuverlaessig, defekte sind sichtbar markiert — Details: Jobportale; Scoring, Filter)
Claude ist ein optionaler Sparringspartner. Er kann dir Feedback zu deinem Lebenslauf geben, Anschreiben formulieren, Interviews simulieren oder Fit-Analysen erstellen. Aber die Kernfunktionen — alles was im Dashboard passiert — laufen komplett ohne KI.
Wenn du die KI-Unterstuetzung nutzen moechtest, brauchst du dafuer nicht mal PBP: Claude Desktop funktioniert auch alleine. Aber mit PBP bekommt Claude Zugriff auf dein Profil, deine Bewerbungen und deine Stellenangebote — und kann dir dadurch viel gezielter helfen. Zum Beispiel: PBP generiert dir aus einer Stellenanzeige einen fertigen Analyse-Prompt, der dein Profil mit der Stelle abgleicht und dir eine Einschaetzung gibt, wie gut du passt.
PBP selbst ist kostenlos und Open Source. Du brauchst allerdings Claude Desktop -- die kostenlose App von Anthropic.
| Plan | Preis | Was geht mit PBP |
|---|---|---|
| Free | $0 | Reinschnuppern, CV analysieren lassen, einzelne Fragen stellen (~20 Nachrichten pro Tag) |
| Pro (empfohlen) | $20/Monat | Alles. Taegliche Nutzung: Jobsuche, Bewerbungen, Interview-Training, Coaching (~45 Nachrichten pro 5 Stunden) |
| Max | $100-200/Monat | Fuer Power-User mit stundenlangen Sessions |
PBP hat keinen Vertrag, keine Kooperation und keinen Verdienst durch Anthropic. Es ist ein Herzensprojekt -- Open Source und kostenlos. Die KI dahinter (Claude) ist ein Service von Anthropic mit begrenztem Kontingent. Mit Claude Pro ($20/Monat) kannst du PBP ohne Einschraenkungen den ganzen Tag nutzen.
Zum Vergleich: Ein einziger professioneller Bewerbungscheck kostet oft 50-150 Euro. Mit PBP + Claude Pro hast du einen persoenlichen Bewerbungs-Coach fuer 20 Dollar im Monat.
Unser Rat: Fang kostenlos an. Installieren, Lebenslauf hochladen, analysieren lassen. Wenn du merkst, dass es dir was bringt, lohnt sich der Volltank.
Alles bleibt lokal auf deinem Rechner. PBP speichert alle Daten in einer einzigen SQLite-Datenbankdatei (pbp.db) auf deiner Festplatte.
- Kein Server, kein Account, kein Cloud-Speicher
- Deine Bewerbungsdaten verlassen niemals deinen Computer
- Wenn du die Datei loeschst, ist alles weg
- Wenn du sie kopierst, hast du ein komplettes Backup
Speicherorte:
| Plattform | Pfad |
|---|---|
| Windows | %LOCALAPPDATA%\BewerbungsAssistent\data\pbp.db |
| macOS / Linux | ~/.bewerbungs-assistent/pbp.db |
Ja -- ueber Export und Import in den Einstellungen:
- Oeffne im Dashboard den Tab Einstellungen
- Unter Export & Backup findest du:
- Komplett-Export (ZIP) -- Alle Daten als ZIP-Datei
- DB-Backup (SQLite) -- Nur die Datenbank
- Profil-Export (JSON) -- Dein Profil als portable JSON-Datei
- Importiere die JSON-Datei auf dem anderen Geraet ueber Profil-Import
So kannst du dein Profil zwischen mehreren Rechnern mitnehmen.
Nein. PBP durchsucht ausschliesslich oeffentlich zugaengliche Stellenanzeigen. Bei keinem der Portale ist ein Account noetig, um Stellen zu finden.
Fuer die Bewerbung selbst kann es sein, dass einzelne Portale einen Account verlangen (z.B. freelance.de, StepStone). Das ist kein PBP-Limit, sondern eine Regel der Stellenboersen. Siehe auch die Wiki-Seite Jobportale.
Nein. PBP bewirbt sich nie automatisch fuer dich. PBP erstellt aus einer Stellenbeschreibung alle Unterlagen -- Fit-Analyse, angepasster Lebenslauf, personalisiertes Anschreiben -- aber du pruefst und verschickst selbst.
PBP gibt dir Perspektive, Struktur und ehrliches Feedback. Die Entscheidungen triffst du.
- Lade die neueste Version herunter (ZIP-Datei)
- Entpacke das ZIP in denselben Ordner (z.B.
C:\PBP) - Fuehre den Installer erneut aus (
INSTALLIEREN.batauf Windows,INSTALLIEREN.commandauf macOS)
Deine Daten (Profil, Bewerbungen, Dokumente) bleiben erhalten -- sie liegen im Datenverzeichnis, nicht im Installationsordner.
Ja. PBP unterstuetzt Multi-Profil. Mehrere Benutzer auf einem PC? Kein Problem:
- "Zeige alle Profile" -- Profile auflisten
- "Wechsle zu Profil XY" -- Aktives Profil wechseln
- "Erstelle ein neues Profil fuer Anna" -- Neues Profil anlegen
Im Dashboard steht der Profil-Wechsler direkt in der Navigationsleiste (Sidebar). Jedes Profil hat eigene Daten, eigene Bewerbungen und eigene Dokumente.
Claude schreibt Aenderungen sofort in die Datenbank — sie sind also direkt gespeichert. Das Dashboard laedt seine Anzeige aber beim Oeffnen einer Seite und aktualisiert sich nicht von selbst, waehrend Claude im Hintergrund arbeitet.
Konkret: Legt Claude im Chat eine neue Stelle oder Bewerbung an, waehrend du das Dashboard offen hast, erscheint sie nicht automatisch in der Liste.
Loesung: Oben rechts in der Kopfzeile gibt es einen Aktualisieren-Knopf (Kreis-Pfeil-Symbol). Ein Klick laedt die aktuelle Seite neu und zeigt alle Aenderungen. Daneben steht „Letzter Sync: HH:MM" — so siehst du, wie aktuell die Anzeige ist. Alternativ kannst du wie gewohnt den Browser neu laden (Strg+F5) oder kurz den Tab wechseln.
Hinweis: Eine automatische Live-Aktualisierung (ohne Knopfdruck) ist als spaetere Ausbaustufe geplant.
Jedes Objekt in PBP — Stelle, Bewerbung, Dokument — hat eine
eindeutige ID. Im Dashboard siehst du sie an der jeweiligen Karte
(kleine Schrift, oft mit Hash-Symbol oder als Kurz-Code wie
8f3a2b1c).
Klick auf die ID kopiert sie in die Zwischenablage — du kriegst eine kurze "ID kopiert"-Bestaetigung. Dann einfach in Claude reinpasten:
"Schau dir Bewerbung 8f3a2b1c an." "Welcher Score hat Stelle abc12345?" "Analysiere Dokument f9e8d7c6."
Claude erkennt die ID und weiss exakt welches Objekt du meinst. Das ist besonders nuetzlich, wenn du mehrere aehnliche Bewerbungen / Stellen / Dokumente hast (z.B. drei "Senior Python Developer"-Treffer bei verschiedenen Firmen, oder mehrere Anschreiben-Versionen) — die ID ist eindeutig, Titel oder Firmenname oft nicht.
Symptom: Claude Desktop ist geoeffnet, aber die PBP-Tools (wie profil_status, stellen_suchen etc.) erscheinen nicht.
Loesung:
-
MCP-Konfiguration pruefen. Die Konfigurationsdatei muss den
bewerbungs-assistent-Eintrag enthalten:Plattform Config-Pfad Windows %APPDATA%\Claude\claude_desktop_config.jsonmacOS ~/Library/Application Support/Claude/claude_desktop_config.jsonLinux ~/.config/Claude/claude_desktop_config.jsonAchtung: Vergleiche nur, ob der Eintrag
bewerbungs-assistentexistiert — die Werte NICHT von Hand aendern. Bei kaputter Config einfachINSTALLIEREN.baterneut ausfuehren.Die Datei muss einen Eintrag wie diesen haben:
{ "mcpServers": { "bewerbungs-assistent": { "command": "python", "args": ["-m", "bewerbungs_assistent"] } } } -
Claude Desktop komplett beenden und neu starten. Fenster schliessen reicht NICHT. Windows: Rechtsklick aufs Claude-Tray-Symbol unten rechts in der Taskleiste (ggf. erst auf den Pfeil „ausgeblendete Symbole" klicken) → Beenden. macOS: Menueleiste → Claude → Quit. Dann neu starten.
-
Installer erneut ausfuehren. Der Installer konfiguriert Claude Desktop automatisch. Wenn die Config fehlt oder beschaedigt ist, loest ein erneuter Installerlauf das Problem.
Symptom: Das Dashboard auf localhost:8200 ist nicht erreichbar.
Loesung:
-
Port 8200 bereits belegt? Ein anderer Prozess oder eine alte PBP-Instanz koennte den Port blockieren.
Windows:
netstat -ano | findstr :8200 taskkill /PID <PID> /FmacOS/Linux:
lsof -i :8200 kill <PID>
-
PBP neu starten. Beende Claude Desktop und starte es neu -- das Dashboard wird automatisch mitgestartet.
-
Dashboard manuell starten:
- Windows: Doppelklick auf die Desktop-Verknuepfung oder
Dashboard starten.bat - macOS: Doppelklick auf
Dashboard starten.commandoder im Terminal:.venv/bin/python start_dashboard.py
- Windows: Doppelklick auf die Desktop-Verknuepfung oder
Symptom: Die Stellensuche liefert keine Ergebnisse.
Loesung:
-
Suchkriterien pruefen. Sind MUSS-Keywords gesetzt? Zu spezifische Keywords (z.B. "Senior Cloud Infrastructure Architect Kubernetes") koennen die Suche einschraenken. Starte breiter und filtere dann.
-
Quellen aktiviert? Pruefe in den Einstellungen (Dashboard > Einstellungen), ob Jobportale aktiv sind. Ohne aktive Quellen kann PBP nicht suchen.
-
Standort und Radius pruefen. Ein zu kleiner Suchradius kann Ergebnisse filtern. Versuche einen groesseren Radius oder lasse den Standort weg.
-
Jobsuche-Workflow nutzen. Sage Claude: "Starte den Jobsuche-Workflow" -- er hilft dir Schritt fuer Schritt bei der optimalen Konfiguration.
-
Haengt die Suche bei 0%? beta.101 installieren — der #668-Fix behebt das Haengenbleiben beim Suchstart.
Symptom: Outlook-.msg-Dateien koennen nicht importiert werden.
Loesung:
-
extract-msg installieren. Das Paket
extract-msgist noetig, um .msg-Dateien zu lesen. Es wird normalerweise vom Installer mitinstalliert. Falls es fehlt:pip install extract-msg
-
Alternative: Als .eml speichern. Oeffne die E-Mail in Outlook und speichere sie als .eml-Datei (Datei > Speichern unter > Dateityp: "Outlook-Nachrichtenformat - Unicode (*.eml)"). Das .eml-Format wird ohne Zusatzpakete unterstuetzt.
-
.eml-Dateien per Drag & Drop. Ziehe die .eml-Datei direkt ins Dashboard -- PBP erkennt sie automatisch und verarbeitet sie.
Symptom: StepStone, Indeed, Monster oder Freelancermap liefern einen Timeout-Fehler.
Loesung:
-
Einzeln aktivieren. Browser-Quellen brauchen mehr Ressourcen. Aktiviere sie einzeln statt alle gleichzeitig.
-
Claude alternativ suchen lassen. Bitte Claude, direkt auf dem Portal zu suchen:
"Suche auf stepstone.de nach Python-Stellen in Hamburg"
Claude oeffnet die Seite, liest die Ergebnisse und uebernimmt sie mit
stelle_manuell_anlegen(). -
Selbst suchen und Link teilen. Oeffne das Portal im Browser, finde interessante Stellen und teile Claude den Link. Er liest die Stellenanzeige und legt sie fuer dich an.
-
Schnelle Quellen bevorzugen. Die schnellen HTTP/API-Quellen (Bundesagentur, Hays, Kimeta, Heise Jobs etc.) sind deutlich zuverlaessiger und schneller. Fuer die meisten Suchen reichen sie aus.
Unter Einstellungen -> Quellen zeigt jede Job-Quelle einen Status. Seit beta.106 wird zwischen "kurz weg" und "dauerhaft kaputt" unterschieden — eine nur temporaer gestoerte Quelle wird nicht mehr dauerhaft abgeschaltet:
| Badge | Bedeutung | Was tun |
|---|---|---|
| OK | Letzter Lauf erfolgreich, Treffer geliefert | nichts |
| Stumm / Leer | Lief durch, aber 0 Treffer | meist normal (Suchbegriffe?) |
| Pausiert | Quelle war kurz weg (Timeout/5xx/Verbindung) — automatischer Probe-Run geplant, kommt von selbst zurueck | abwarten, oder "Jetzt reaktivieren" |
| Blockiert | Quelle hat geblockt (403/429) — pausiert, respektiert Retry-After | abwarten; bei Login-Quellen ggf. neu anmelden |
| Tot | Endpoint weg (404/410) — hart deaktiviert | Quelle ist umgezogen/eingestellt; manueller Weg via Chrome-Extension |
| Kaputt | Adapter/Parser-Fehler — hart deaktiviert | braucht einen Code-Fix (gern als Issue melden) |
Der Button "Jetzt reaktivieren" schaltet eine pausierte/deaktivierte Quelle sofort wieder scharf (ohne auf den geplanten Probe-Run zu warten). Bei Tot und Kaputt lohnt das meist nicht — die kommen nicht von selbst zurueck.
Symptom: Bei einer Stelle steht nichts im URL-Feld, oder der Link
fuehrt auf eine generische Suchseite statt auf die konkrete Anzeige.
Im Detail-Dialog erscheint ein is_search_url-Hinweis.
Hintergrund: Manche Scraper (XING/Stepstone in Login-bedingten Faellen, Recruiter-Mails ohne Link) liefern keine Detail-URL. Statt das Feld leer zu lassen, faellt PBP auf die Such-URL zurueck und markiert das transparent.
Loesung (beta.71+):
"Stelle S-0042 hat keine richtige URL. Pflege sie nach."
Claude sucht via WebSearch nach Firma+Titel, findet die echte URL und setzt sie:
stelle_bearbeiten('<hash>', url='https://...')
Anschliessend:
stellenbeschreibung_nachladen('<hash>')
zieht die Beschreibung nach und der Score wird neu berechnet. Siehe Stellen-Qualitaet fuer den Vollzyklus.
Symptom (vor beta.74): Aufruf von stellen_bulk_bewerten oder
stellen_auto_aussortieren mit grossen Treffermengen lief reproduzierbar
in einen 4-Minuten-Timeout, auch bei Dry-Run mit nur 5 Treffern.
Ursache: Bei stellen_auto_aussortieren macht Ollama N sequentielle
Inferenz-Calls (je 5-30s lokal). 50 Stellen × 10s = 8 Min → Client-Timeout.
Bei stellen_bulk_bewerten SQLite-Lock-Konflikt mit dem parallelen
Auto-Engine-Step _run_auto_refetch_descriptions.
Loesung in beta.74:
-
stellen_auto_aussortierenhat jetzt einen Hard-Cap von 10 Stellen pro Lauf (vorher 50) und ein Wall-Clock-Budget von 180s. Bei Erreichen kommtstatus='teilweise'mit Teil-Ergebnis statt stillem Haengen. Idempotent fortsetzbar — einfach erneut aufrufen. -
stellen_bulk_bewertenhat ein 90s-Budget mit klaremstatus='timeout'-Return. Bei Timeout: engere Filter (max_treffer,min_score) oder kurz warten bis Auto-Engine-Step durch ist.
Update: Seit beta.101 (#691) liegt das Budget von
stellen_auto_aussortieren bei 50s Default (bis 90s via
max_dauer_sek); bei Erreichen kommt ein sauberes Teil-Ergebnis.
Workaround bei aelteren Versionen: Einzelne stelle_bewerten-Calls
in Schleife — funktioniert, ist aber langsamer.
Allgemeine Wurzel behoben in beta.105 (#723): Dashboard und MCP-Server
sind zwei Prozesse, die sich dieselbe pbp.db teilen — SQLite erlaubt nur
einen Schreiber. Pflegtest du im Dashboard, waehrend Claude ueber den MCP
schreibt, konnte ein Write sporadisch in den 4-Minuten-Client-Timeout laufen
("MCP antwortet nicht"). Jetzt wartet ein Write bis zu 30s auf die Freigabe
des anderen (busy_timeout, WAL-Modus) und geht dann durch, statt zu haengen
oder sofort zu scheitern. Ein geleakter Write-Lock wird zusaetzlich am
Tool-Ende automatisch zurueckgerollt (#708). Falls doch mal etwas haengt:
Dashboard-Tab kurz schliessen oder Claude Desktop neu starten loest es.
🗺 Plan
- Master-Plan
- Master-Plan-Optimierung
- Plan-Datenbasis (A)
- Plan-Jobsuche (B)
- Plan-Stellen (C)
- Plan-Bewerbungen (D)
- Plan-Dokumente (E)
- Plan-Lokale-KI (F)
- Plan-Frontend (G)
- Plan-MCP-Layer (H)
- Plan-Distribution (I)
- Plan-Roadmap-v18 (J)
Einstieg
Tabs
Features
- Elwosa
- Lern-System
- Lokale KI & KI-Steuerung
- Profile-Cluster
- Suchkriterien & Gewichtungen
- Profil aus Dokumenten
- Workflows
- Jobportale
- Stellen-Qualitaet
Reference