Skip to content

MadGapun/PBP

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

310 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

PBP Logo PBP — Persönliches Bewerbungs-Portal

An ELWOSA Project

🌍 Note for international users: PBP currently supports the German-speaking job market (DACH region) only. All tools, workflows, job portals, and UI are in German. Interested in support for your country? Open an issue!

PBP verwaltet deine Bewerbungen, durchsucht diverse Stellenportale und gibt dir ehrliches Feedback zu deinen Unterlagen — mit konkreten Vorschlägen, wie es besser geht. Läuft lokal, kostet nichts, deine Daten bleiben bei dir.

Python 3.11+ MCP License: MIT Stable Tests Tools Workflows Plattformen Wiki


So funktioniert PBP

PBP führt dich Schritt für Schritt durch deine Bewerbungen — auch wenn du lange keine geschrieben hast.

Schritt Was passiert
1. Du erzählst kurz von dir Claude führt dich durch ein Kennenlerngespräch und baut dein Profil auf. Du musst nichts vorbereiten.
2. PBP findet passende Stellen Jobbörsen werden automatisch durchsucht. Du bekommst eine bewertete Liste.
3. Du bewirbst dich — mit Unterstützung Anschreiben, Lebenslauf, Interview-Vorbereitung — PBP begleitet dich bei jedem Schritt.

💡 Wichtig: PBP arbeitet zusammen mit Claude Desktop. Du wirst an bestimmten Stellen automatisch dorthin weitergeleitet — das ist Teil des Ablaufs. Claude ist dein Gesprächspartner, das Dashboard deine Übersicht.


Warum PBP?

Mal ehrlich: Weißt du, wie dein Lebenslauf auf einen Recruiter wirkt? Auf ein ATS-System? Auf einen Personalberater?

Die meisten Bewerber wissen es nicht. Sie schreiben ihren CV einmal, kopieren das Anschreiben mit minimalen Änderungen und wundern sich über Absagen. Nicht weil sie schlecht sind — sondern weil niemand ihnen ehrlich sagt, was sie besser machen könnten.

PBP ist dieser ehrliche Sparringspartner.

Was PBP anders macht

PBP ist kein Tool, das alles für dich erledigt und du drückst nur auf "Absenden". PBP gibt dir Perspektive, Struktur und ehrliches Feedback — die Entscheidungen triffst du.

Du fragst dich... PBP hilft dir so
"Ist mein Lebenslauf gut genug?" 3-Perspektiven-Analyse — Wie wirkt dein CV auf einen Personalberater, ein ATS-System und einen Recruiter?
"Passe ich überhaupt auf die Stelle?" Fit-Analyse — Punkt-für-Punkt-Vergleich Profil vs. Stelle. Ehrlich, nicht schöngerechnet.
"Was fehlt mir noch?" Skill-Gap-Analyse — Welche Fähigkeiten verlangt die Stelle, die du (noch) nicht hast?
"Was soll ich im Interview sagen?" Interview-Simulation — Claude spielt den Interviewer auf Basis der echten Stelle.
"Wie verhandle ich das Gehalt?" Gehaltsverhandlung — Markdaten, Strategie, konkrete Argumente.

Und wenn du mehr willst

  • 24 Jobportale konfiguriert, 17 davon aktiv liefernd — Indeed, LinkedIn, Glassdoor und Google ueber JobSpy, Stepstone, Hays, Bundesagentur, Greenhouse, Arbeitnow und mehr; 7 weitere sind als „defekt" sichtbar markiert mit Chrome-Extension-Workaround
  • Angepasste Lebensläufe — Für jede Stelle ein CV, in dem Skills nach Relevanz sortiert sind
  • E-Mail-Import — Drag & Drop deine Firmen-Mails rein. Status und Termine werden automatisch erkannt
  • Kalender — Grafisches Grid mit Kategorien, Kollisionserkennung und .ics-Export
  • Bewerbungs-Tracking — Pipeline mit Timeline, Notizen, Follow-ups und Statistiken
  • Scoring-Regler — Konfiguriere, was dir wichtig ist. PBP sortiert automatisch

📖 Alle Features im Detail: Wiki → Dashboard · Workflows · MCP-Tools · Jobportale

Einfach reden — keine Befehle nötig

Du musst keine Kommandos kennen. Du redest einfach mit Claude, wie mit einem Menschen.

"Schau mal über meinen Lebenslauf" "Ich hab ne Absage bekommen, was mach ich falsch?" "Bereite mich auf das Interview morgen vor" "Suche was mit Python in Hamburg"

🎙️ Oder einfach sprechen: Drück aufs Mikrofon in Claude Desktop und rede. Interview-Training, Profilerstellung, Feedback — alles geht auch per Sprache.


Voraussetzungen

PBP läuft über Claude Desktop — die kostenlose App von Anthropic für Windows, Mac und Linux.

Free Pro ⭐ empfohlen Max
Preis $0 $20/Monat $100–200/Monat
Was geht mit PBP Reinschnuppern, CV analysieren lassen, einzelne Fragen stellen Alles. Tägliche Nutzung: Jobsuche, Bewerbungen, Interview-Training, Coaching Für Power-User mit stundenlangen Sessions
Nachrichten ~20 pro Tag ~45 pro 5 Stunden (5× mehr) 5×–20× mehr als Pro
MCP-Tools (PBP) ✅ Funktioniert ✅ Funktioniert ✅ Funktioniert
Mikrofon/Sprache ✅ Ja ✅ Ja ✅ Ja

Vorab, ganz offen: Wir — die Macher von PBP — haben keinen Vertrag, keine Kooperation und keinen Verdienst durch Anthropic (die Firma hinter Claude). Wir verdienen nichts an diesem Tool. PBP ist ein Herzensprojekt, Open Source, kostenlos.

Trotzdem wollen wir ehrlich sein: Die KI dahinter (Claude) ist ein Service von Anthropic, und der hat Grenzen.

Stell dir PBP vor wie ein Auto mit eingebautem Navi, das du geschenkt bekommst. Fahren kannst du sofort — kostenlos. Alles funktioniert, keine Begrenzung von unserer Seite. Aber nach ein paar Kilometern musst du an die Tankstelle, warten bis der Tank wieder voll ist, und dann weiterfahren. So funktioniert der Free-Plan: Du kommst vorwärts, aber in Etappen. Claude wird fürs Denken bezahlt — nicht von uns, sondern von Anthropic.

Mit Claude Pro ($20/Monat) tankst du voll — und fährst den ganzen Tag ohne Pause. Jobsuche, Bewerbungen schreiben, Interview-Training, Coaching — alles in einer Session, so viel du willst.

Zum Vergleich: Ein einziger professioneller Bewerbungscheck kostet oft 50–150 €. Mit PBP + Claude Pro hast du einen persönlichen Bewerbungs-Coach für 20 Dollar im Monat — so oft du willst, so lange du willst.

Unser Rat: Fang kostenlos an. Installieren, Lebenslauf hochladen, analysieren lassen. Wenn du merkst, dass es dir was bringt — und das wirst du — dann lohnt sich der Volltank.

Das Besondere

  • Einfach reden — oder sprechen. Kein Formular, keine Befehle. Tippen oder Mikrofon drücken — Claude versteht beides.

⚠️ Deine Daten bleiben auf deinem Rechner. PBP speichert alles in einer einzigen lokalen Datenbankdatei auf deiner Festplatte (pbp.db). Kein Server, kein Account, kein Cloud-Speicher. Wenn du die Datei löschst, ist alles weg. Wenn du sie kopierst, hast du ein komplettes Backup. So einfach. Deine Bewerbungsdaten verlassen niemals deinen Computer.

  • Festanstellung & Freelance. Egal ob fester Job oder Projektaufträge — PBP unterstützt beides.
  • Multi-Profil. Mehrere Benutzer auf einem Rechner? Kein Problem — jedes Profil hat eigene Daten.
  • Open Source & kostenlos. PBP selbst kostet nichts. Du brauchst nur Claude Desktop (Free oder Pro).
  • Tagesimpulse mit Glueckskeks-Charakter. 169 kuratierte Sprueche, einer pro Tag, kontextbezogen. Manche sind klar, andere lesen sich beim ersten Mal wie billig uebersetzte Bambusstaebchen-Weisheiten — da brauchst du zwei Schluck Kaffee, dann ergibt's Sinn. Oder auch nicht. It's not a bug, it's a feature.

Schnellstart

Windows (Empfohlen)

  1. Lade die neueste Version herunter (ZIP-Datei)
  2. Entpacke das ZIP in einen Ordner (z.B. C:\PBP)
  3. Doppelklicke INSTALLIEREN.bat — fertig!

Voraussetzungen: Windows 10/11 (64-Bit), Internetverbindung, Claude Desktop

macOS

  1. Lade die neueste Version herunter (ZIP-Datei)
  2. Entpacke das ZIP
  3. Doppelklicke INSTALLIEREN.command — fertig!

Voraussetzungen: macOS 12+, Python 3.11+ (brew install python@3.12), Claude Desktop

Linux

git clone https://github.com/MadGapun/PBP.git && cd PBP && bash installer/install.sh

📖 Detaillierte Anleitungen, Claude Desktop Config und Fehlerbehebung: Wiki → Installation

Erste Schritte

Öffne Claude Desktop und sage:

"Starte die Ersterfassung"

Claude führt dich durch ein lockeres Gespräch (ca. 10-15 Minuten) und baut dein Profil auf. Schneller geht's mit Dokumenten: Lade deinen Lebenslauf als PDF oder DOCX hoch — PBP extrahiert die Daten automatisch.

📖 Schritt-für-Schritt-Anleitung: Wiki → Erste Schritte


Screenshots

UI-Design von @Koala280 — React 19 + Vite + Tailwind CSS

Erster Start — So begruesst dich PBP

Willkommen

Profil unvollstaendig — PBP zeigt dir den naechsten Schritt

Profil unvollstaendig

Alles eingerichtet — Dashboard im Normalbetrieb

Dashboard vollstaendig

Dashboard — "Im Fluss", Termine und Schnellimport

Dashboard

Profil — Berufserfahrung, Skills, Ausbildung

Profil

Stellen — Scoring, Filter und Fit-Analyse

Stellen

Bewerbungen — Pipeline mit Follow-ups und Dossier

Bewerbungen

Dokumente — Upload, Verknuepfung und Analyse

Dokumente

Kalender — Grafisches Grid mit Kategorien

Kalender

Statistiken — Charts mit flexiblen Zeitraeumen

Statistiken

Einstellungen — Quellen, Export & Backup, Datenschutz

Einstellungen


Auf einen Blick

Plattformen Windows, macOS, Linux
MCP-Tools 95 Tools in 8 Modulen
Workflows 18 gefuehrte Workflows
Jobportale 24 Quellen (17 aktiv liefernd inkl. Indeed/LinkedIn/Glassdoor/Google ueber JobSpy + Greenhouse + Arbeitnow, 7 als defekt sichtbar markiert mit Chrome-Workaround)
Dashboard 8 Tabs: Dashboard, Profil, Stellen, Bewerbungen, Dokumente, Kalender, Statistiken, Einstellungen
Datenbank SQLite (WAL), Schema v28
Tests 537 bestanden

📖 Technische Details: Wiki → Architektur · MCP-Tools · Jobportale


Roadmap

v1.7.0 wird ein tiefer Eingriff mit Local-LLM-Foundation (Ollama-Sidecar). Strategische Uebersicht: docs/ROADMAP_v1.7.0.md Detail-Issue mit Anwendungsfaellen: #512

Changelog

Vollstaendiges Changelog: CHANGELOG.md

v1.6.3 — Anti-DB-Bypass-Pattern (Hotfix, 2026-04-27)

Drei Hebel um zu verhindern dass Claude bei groesseren Datenmengen die PBP-Lifecycle-Logik durch direkte SQLite-Writes umgeht:

  • stellen_bulk_bewerten — Filter-basiertes Bulk-Aussortieren mit dry_run=True Default. Loest den Real-Case „500 Stellen, hunderte falsches Fachgebiet, sortier mir die alle aus" in einem Tool-Call statt 200 Einzelaufrufen.
  • pbp_capabilities — Read-only Meta-Tool das Claude eine kuratierte Tool-Uebersicht liefert (10 Kategorien). Damit Claude weiss was PBP kann, bevor es auf andere MCP-Tools ausweicht.
  • pbp_grenze_melden — Wenn PBP fuer einen Use-Case nichts hat, wird die Grenze geloggt und ein vorausgefuellter GitHub-Issue-Body geliefert. Strukturierte Reibung beim Bypass-Versuch.

Plus: PBP-MCP-Server-Instructions die beim Initialize-Handshake an Claude gesendet werden — Anti-Bypass-Hinweis ist damit Teil des System-Kontextes, nicht erst Reaktion auf einen Workaround-Versuch.

v1.6.2 — Foundation-Release (Stable, 2026-04-26)

Stabiler Abschluss von 35 Beta-Iterationen plus drei User-Findings. Versionsnummer-Hinweis: die Tags v1.6.0 und v1.6.1 wurden durch GitHubs „Immutable releases"-Feature unbrauchbar; die offizielle Foundation-Stable-Linie startet daher bei v1.6.2. Vollstaendiger Sprint-Verlauf und User-Stories: siehe CHANGELOG.md.

v1.6.0-beta.* (2026-04-23 bis 2026-04-26) — Sprint-Themen

Foundation-Release nach 35 Beta-Iterationen — alles unter der Haube ueberholt:

  • Linke Sidebar-Navigation (#508) — neuer Layout-Refactor (Variante B): Top-Nav weg, Sidebar mit Hover-to-Expand-Overlay, Status-Block (Version + MCP-Heartbeat), Sub-Navigation pro Bereich, Path-Breadcrumb in der Top-Bar.
  • Bewerbungs-ZIP-Export (#474) — kompletter Export pro Bewerbung als ZIP: bericht.html, stelle.html, notizen.md, termine.ics, mails.md, dokumente/, mails/, INHALT.md, optional bericht.pdf via Playwright.
  • Scraper reanimiert (#502, #499, Phase 1-3) — Adapter v2 mit AdapterStatus, scraper_health-Tabelle, Silent-Detection. JobSpy als Core-Dependency: Indeed/LinkedIn/Glassdoor/Google ohne API-Key, ohne Kosten. Greenhouse + Arbeitnow als neue DACH-Adapter. Tote Quellen sichtbar ausgegraut mit Chrome-Extension-Fallback.
  • Skill-Datenmodell Schema v28start_year, end_year, level_current. Skill-Editor mit Punkt-Visualisierung (5 Dots), Skill-Karte zeigt echten Datumsbereich statt zurueckgerechnetem currentYear - years_experience.
  • Keyword-Vorschlaege ueberarbeitet — erweiterte Stopwords, TF-IDF Specificity, applied vs dismissed Datasource, strikte Exklusion (good_words==0). Frontend-Endpoint und MCP-Tool synchronisiert.
  • Statistik ISO-Wochen-Aggregation — Python _iso_week_key, da SQLite %V nicht kennt; current-period nicht mehr ausgefiltert (vorher endete Chart bei KW-1).
  • Eigenes PBP-Icon (#502) — multi-resolution assets/pbp.ico, Desktop-Verknuepfung zeigt PBP-Logo statt generischem Batch-Icon.
  • Konfigurierbare Hints-Quelle — neue PBP_HINTS_URL ENV-Variable (lokaler Pfad oder off) fuer Tests und Screenshots.
  • Installer-Konsistenz — INSTALLIEREN.bat / install.ps1 / install.sh / setup_gui.py auf v1.6.0-Stand, Port 8200 ueberall, Playwright + Chromium standardmaessig.

Schema v28, 92 Tools, 18 Prompts, 537 Tests bestanden, 24 Quellen.

v1.5.0 — Kalender, macOS, E-Mail-Pipeline, Dashboard-Redesign (2026-04-10)

Das groesste Update seit dem ersten Public Release:

  • macOS offiziell unterstuetzt — Doppelklick-Installer, Dashboard-Starter, Deinstaller
  • Kalender-System — Grafisches Grid, CRUD, benutzerdefinierte Kategorien, .ics-Export, Kollisionserkennung
  • E-Mail-Pipeline — Import (.msg/.eml), automatische Zuordnung, Status-Erkennung, Termin-Extraktion
  • Dashboard-Redesign — "Im Fluss" + Schnellimport, Follow-ups ueber Bewerbungen
  • Export & Backup zentralisiert — Komplett-Export, DB-Backup und Profil-Import in den Einstellungen
  • Schema v23, 73 Tools, 18 Prompts, 401 Tests

v1.0.0 — Erster Public Release (2026-03-26)

  • 72 Tools, 16 Prompts, 18 Quellen, React 19 Dashboard
  • E-Mail-Integration, Multi-Profil, Scoring-Regler, Geocoding, CV-Export

FAQ

Brauche ich ueberhaupt eine KI? Nein! PBP ist ein eigenstaendiges Verwaltungstool. Ohne Claude kannst du: Bewerbungen verwalten, Dokumente organisieren, Termine planen, Statistiken auswerten, E-Mails importieren und Follow-ups tracken. Claude ist ein optionaler Sparringspartner — er kann dir Feedback geben, Anschreiben formulieren oder Interviews simulieren. Aber die Kernfunktionen laufen komplett ohne KI.

Brauche ich einen Claude Pro Account? Nein — PBP funktioniert mit jedem Claude Desktop Account, auch dem kostenlosen. Ein Pro-Account hat hoehere Nutzungslimits, was bei vielen Jobsuchen hilfreich sein kann.

Werden meine Daten in die Cloud geschickt? Deine Profildaten, Bewerbungen und Dokumente bleiben lokal auf deinem Rechner (SQLite). Wenn du Claude nutzt (Gespraech, Anschreiben, Fit-Analyse), werden die relevanten Daten an Claude gesendet — wie bei jeder normalen Claude-Konversation.

Kann ich PBP ohne Jobportale nutzen? Ja! Du kannst PBP auch nur fuer Profilerstellung, Lebenslauf-Export und Bewerbungstracking nutzen, ganz ohne Stellensuche.

Browser nicht gefunden / Chrome nicht verbunden?

  1. Microsoft Edge schliessen (auch im System-Tray pruefen)
  2. Google Chrome manuell oeffnen falls nicht offen
  3. PBP-Suche erneut starten

Hintergrund: PBP versucht den Standard-Browser zu steuern. Wenn Edge geoeffnet ist, kann PBP sich mit Edge statt Chrome verbinden und scheitert dann.

📖 Weitere Fragen und Troubleshooting: Wiki → FAQ


Lizenz

MIT License — Markus Birzite


Credits

Markus Birzite — Idee, Konzept, Architektur & Projektleitung

Hat PBP erdacht, die Vision definiert und das Projekt von Anfang an geleitet. Treibt Richtung, Priorisierung und Qualität.

Claude (Anthropic) — Entwicklung, Code, Dokumentation, Tests

Hauptentwickler seit v0.1.0. Hat den Großteil des Codes geschrieben — Backend, Frontend-Integration, Scraper, Tests, Installer, Dashboard, E-Mail-Service. Jeder Commit trägt seinen Namen. Intern: "der Onkel".

ChatGPT (OpenAI) — Bewertung, Analyse & Qualitätssicherung

Die neutrale Instanz im Team. Bewertet Ergebnisse von Claude und Codex, liest jede Analyse quer, hinterfragt Annahmen und stellt sicher, dass nichts schöngeredet wird. Intern: "die Mama".

Codex (OpenAI) — Code-Analyse, Recovery & Bugfixes

Kommt ins Spiel wenn größere Code-Analysen, Refactorings oder Recovery-Aufgaben anstehen. Hat u.a. das Frontend-Recovery (v0.25.2) durchgeführt und liefert zuverlässig Fixes für komplexe Bugs. Intern: "die Tante".

Toms (@Koala280) — React-Frontend, Testing & Sparringspartner

Hat das React 19 + Vite + Tailwind Frontend beigesteuert (v0.23.0, 7.877 Zeilen), das System ausgiebig getestet und als Diskussionspartner die UX mitgeformt. AI & Data Science Student.

ELWOSA — Fundament, Projektmanagement & Dateninfrastruktur

Die allererste PBP-Version lief direkt auf der ELWOSA-Datenbank — dort wurde der Prototyp entwickelt und erprobt, bevor er zur eigenständigen Anwendung umgebaut wurde. ELWOSA liefert bis heute Projektmanagement, Server-Infrastruktur, CI/CD-Prozesse und Entwicklungsmethodik.

Third-Party-Bibliotheken

  • python-jobspy (MIT) — seit v1.6.0-beta.3 als optionale Scraper-Quelle fuer LinkedIn und Indeed.de verwendet (#490). Kein API-Key, keine Kosten.

Kaffee spendieren
An ELWOSA Project