PBP laesst sich auf Windows, macOS und Linux installieren. Auf Windows geht es am einfachsten — ein Doppelklick auf INSTALLIEREN.bat reicht.

• Windows (Empfohlen)
• macOS
• Linux / Manuell
• Claude Desktop konfigurieren
• Datenverzeichnis
• Nach der Installation
• Deinstallation

• Windows 10 oder 11 (64-Bit)
• Internetverbindung
• Claude Desktop (Free reicht zum Ausprobieren, Pro empfohlen fuer taegliche Nutzung)

1. Lade die neueste Version herunter (ZIP-Datei unter "Source code (zip)")
2. Entpacke das ZIP in einen Ordner deiner Wahl, z.B. C:\PBP
3. Doppelklicke INSTALLIEREN.bat — der Rest passiert automatisch

Wichtig: Das ZIP muss vollstaendig entpackt werden. Die BAT-Datei darf nicht direkt aus dem ZIP heraus gestartet werden.

Der Installer fuehrt folgende Schritte automatisch durch:

1. Python herunterladen — Embedded Python 3.12 wird heruntergeladen und eingerichtet (nur wenn noch nicht vorhanden)
2. Pakete installieren — Alle Abhaengigkeiten werden installiert (inkl. setuptools, wheel)
3. Claude Desktop konfigurieren — Der MCP-Server-Eintrag bewerbungs-assistent wird in die Claude-Konfiguration geschrieben
4. Desktop-Verknuepfung erstellen — "PBP Bewerbungs-Portal" erscheint auf dem Desktop
5. Backup deiner Datenbank — vor jedem Update wird automatisch ein Backup erstellt (data\backups\)
6. Automatischer Start — am Ende werden Claude Desktop und das Dashboard automatisch gestartet

Du musst nichts selber installieren oder konfigurieren.

• Claude Desktop beenden und neu starten
• In Claude eingeben: "Starte die Ersterfassung"

• macOS 12 oder neuer
• Python 3.11+ (Installation siehe unten)
• Claude Desktop fuer Mac

1. Claude Desktop installieren von claude.ai/download

2. Python 3.11+ installieren (falls nicht vorhanden) — entweder mit dem Installer von python.org oder per Homebrew:

   brew install python@3.12

3. PBP installieren — eine der beiden folgenden Varianten.

1. ZIP herunterladen von der Release-Seite (unter Assets → „Source code (zip)")
2. Entpacken (Doppelklick reicht)
3. Doppelklick auf INSTALLIEREN.command — falls macOS warnt: Rechtsklick auf die Datei → „Oeffnen"

Repository klonen und Installer starten:

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

Der Installer (install.sh v2.0) fuehrt 7 Schritte durch:

• Claude Desktop beenden (Menueleiste > Claude > Beenden) und neu starten
• In Claude eingeben: "Starte die Ersterfassung"

Doppelklick auf Dashboard starten.command oder:

.venv/bin/python start_dashboard.py

• Python 3.11+
• git
• Optional: Node.js + pnpm (fuer das React-Frontend)

# Repository klonen
git clone https://github.com/MadGapun/PBP.git
cd PBP

# Installer starten (inkl. Claude Desktop Config)
bash installer/install.sh

Der Installer funktioniert identisch wie auf macOS (siehe oben).

Hinweis: Claude Desktop ist fuer Linux nicht offiziell verfuegbar. Als Alternative funktioniert Claude Code (CLI) mit MCP-Support. Der Installer erkennt das automatisch und zeigt einen Hinweis.

# Repository klonen
git clone https://github.com/MadGapun/PBP.git
cd PBP

# Virtuelle Umgebung erstellen
python3 -m venv .venv
source .venv/bin/activate

# Core installieren
pip install -e ".[docs]"

# Optional: Scraper mit Playwright (fuer StepStone, Indeed, Monster etc.)
pip install -e ".[all]"
playwright install chromium

.venv/bin/python -m bewerbungs_assistent

.venv/bin/python start_dashboard.py

Die Installer (INSTALLIEREN.bat bzw. install.sh) konfigurieren Claude Desktop automatisch. Dieser Abschnitt ist nur fuer manuelle Konfiguration relevant.

Fuege folgenden Eintrag in die Datei ein (oder ergaenze den bestehenden mcpServers-Block):

{
  "mcpServers": {
    "bewerbungs-assistent": {
      "command": "python",
      "args": ["-m", "bewerbungs_assistent"],
      "env": {
        "BA_DATA_DIR": "/pfad/zu/deinen/daten"
      }
    }
  }
}

Wichtig:

• command muss auf das Python in deiner virtuellen Umgebung zeigen (z.B. .venv/bin/python oder der volle Pfad)
• BA_DATA_DIR ist optional — ohne diesen Eintrag wird der Standardpfad verwendet (siehe Datenverzeichnis)
• Nach Aenderungen Claude Desktop komplett beenden und neu starten

PBP speichert alle deine Daten lokal auf deinem Rechner. Nichts wird in die Cloud hochgeladen.

Windows:

%LOCALAPPDATA%\BewerbungsAssistent\
├── app\             ← PBP Runtime (Python + Source Code)
├── data\
│   ├── pbp.db       ← Deine Datenbank (Profil, Jobs, Bewerbungen)
│   ├── dokumente\   ← Hochgeladene Dokumente
│   ├── export\      ← Generierte Lebenslaeufe und Anschreiben
│   └── logs\        ← Protokolle

macOS / Linux:

~/.bewerbungs-assistent/
├── pbp.db           ← Deine Datenbank
├── dokumente\       ← Hochgeladene Dokumente
├── export\          ← Generierte Lebenslaeufe und Anschreiben
└── logs\            ← Protokolle

Du kannst das Datenverzeichnis ueber die Umgebungsvariable BA_DATA_DIR aendern:

{
  "mcpServers": {
    "bewerbungs-assistent": {
      "env": {
        "BA_DATA_DIR": "D:\\MeineBewerbungen"
      }
    }
  }
}

1. Claude Desktop starten (nach Neustart)
2. Unten links bei den MCP-Tools pruefen, ob "bewerbungs-assistent" aufgefuehrt wird
3. Eingeben: "Starte die Ersterfassung" — PBP sollte sich melden

Tipp: Du kannst auch deinen Lebenslauf als PDF oder DOCX hochladen — PBP extrahiert die Daten automatisch und fragt nur noch nach, was fehlt.

Das Web-Dashboard startet automatisch auf http://localhost:8200 und bietet eine grafische Oberflaeche fuer Profil, Stellen, Bewerbungen, Statistiken und Einstellungen.

1. Doppelklicke DEINSTALLIEREN.bat im PBP-Ordner

Der Deinstaller fuehrt 7 Schritte durch:

Standardmaessig bleiben deine Bewerbungsdaten erhalten. Du wirst explizit gefragt, ob du sie loeschen moechtest. Ein Desktop-Backup kann vorher erstellt werden.

Nach der Deinstallation: Claude Desktop einmal komplett neu starten.

cd PBP
bash installer/deinstallieren.sh

Der Deinstaller:

Hinweis: Der Quellcode (das geklonte Repository) wird nicht automatisch entfernt. Den PBP-Ordner kannst du manuell loeschen.

Nach der Deinstallation: Claude Desktop einmal komplett neu starten.

Falls die Deinstaller nicht funktionieren:

1. MCP-Eintrag entfernen: Oeffne die Claude Desktop Config und loesche den bewerbungs-assistent-Eintrag aus mcpServers
2. Datenverzeichnis loeschen: Siehe Standard-Pfade oben
3. PBP-Ordner loeschen: Den entpackten/geklonten Ordner entfernen
4. Claude Desktop neu starten