README.en.md
Rama main · réplica de lectura del repositorio original.
[Deutsch](README.md) | **English**
# <img src="docs/pbp.png" alt="PBP logo" width="36" align="absmiddle" /> PBP — Persönliches Bewerbungs-Portal
**PBP is a job application assistant for the German-speaking job market (DACH). Data is stored on your machine — free, open source, no cloud storage; what you work on with Claude is sent to Anthropic.**
## Honest scope note
PBP is a German-language product for people applying to jobs in Germany, Austria and Switzerland. The UI, the workflows, the job portal integrations and the documentation are German — and that is deliberate: cover letters, CV conventions and job boards are deeply local. If that is your job market, switch to the [German README](README.md).
If you do not speak German, the interesting part of this repo is the architecture.
## Why this repo might still interest you
PBP is a complete, self-hosted **MCP server** (Model Context Protocol) written in Python (FastMCP), paired with a React 19 dashboard and a single-file SQLite database:
- **MCP tools** covering profile management, job search, application tracking, document analysis, calendar, statistics and guided workflows
- **Job sources chosen by occupational field**, with honest health checks — sources that currently deliver nothing are visibly flagged instead of failing silently
- **Local-first by design** — one SQLite file holds all data; what you work on with Claude (profile, document text, job ads, notes) goes to Anthropic, and each area can be switched off in the settings
- **Claude Desktop as the interface** — no custom chat UI; conversation, voice input and tool calls come for free via MCP
- **Local LLM sidecar** (Ollama) for background classification and scoring, so routine work costs no cloud tokens
- **Automated tests with a mutation check per release**, weekly releases
Current version and changes: see [Releases](https://github.com/MadGapun/PBP/releases/latest) · MIT license
## Fork it for your job market
The concept — a local MCP server that manages applications, watches job boards and gives honest feedback on CVs — transfers to any country. Scraper adapters, scoring rules and the document pipeline are pluggable. If you would like to build an equivalent for your market, fork the repo or [open an issue](https://github.com/MadGapun/PBP/issues) — questions are answered in English too.
## Quick facts
| | |
|---|---|
| Platforms | Windows, macOS, Linux |
| Interface | Claude Desktop (MCP) + local web dashboard |
| Storage | Single SQLite file (WAL mode) |
| Cost | Free (MIT license); optional Claude Pro for heavy daily use |
| Product language | German — see the [German README](README.md) for the full feature tour |
---
[Deutsch](README.md) | **English**