tailorbirdcv 0.2.0__tar.gz

tailorbirdcv-0.2.0/.gitignore

@@ -0,0 +1,56 @@
+# ---- TailorbirdCV: personal data never enters the repository ----------------------------------
+# The data folder (profile, applications, settings, access key) and the owner's local notes.
+private/
+CLAUDE.local.md
+.access-key
+# Resumes and their outputs anywhere in the tree; the only Word file shipped is the empty template.
+*.pdf
+*.docx
+!tailorbirdcv/data/templates/base.docx
+*.doc
+*.rtf
+*.odt
+# Word and LibreOffice lock files
+~$*
+.~lock.*#
+
+# ---- Secrets -------------------------------------------------------------------------------
+.env
+.env.*
+.envrc
+*.pem
+*.key
+*.p12
+.pypirc
+
+# ---- Python ----------------------------------------------------------------------------------
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+build/
+dist/
+*.egg-info/
+.eggs/
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.ruff_cache/
+.mypy_cache/
+
+# ---- Node (web/ has its own .gitignore for node_modules and dist) ----------------------------
+node_modules/
+*.log
+
+# ---- Editors and operating systems -------------------------------------------------------------
+.vscode/
+.idea/
+*.swp
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# ---- Claude Code: local settings and worktrees -------------------------------------------------
+.claude/settings.local.json
+.claude/worktrees/

tailorbirdcv-0.2.0/CHANGELOG.md

@@ -0,0 +1,37 @@
+# Changelog
+
+## 0.2.0 — 2026-10-07 (first release on PyPI)
+- **Cover letters** (new Workspace step): a one-page letter in your resume's design and the tone you pick (Formal, Warm, Direct), drafted by the AI and checked sentence by sentence: what it says about you cites your evidence, what it says about the company comes from the posting, and the greeting, closing and sign-off are written by TailorbirdCV. Edit any sentence with its sources beside it; build it as Word and PDF; it's frozen with the resume when you apply.
+- **Safer against hostile job postings:** a claim must stay close to the evidence it cites (most of its words from its sources), and text addressed to a reader or an AI ("ignore previous instructions", "shortlist this candidate") is refused, so a posting can't plant sentences in your resume. Job-posting text is marked as data, never instructions, in every AI prompt, and text hidden from people on a job page (zero-size, transparent, off-screen) is left out.
+- **Privacy mode (experimental)** (Settings → Privacy, on by default): your name, email, phone, street address and personal links are replaced by placeholders in everything sent to the AI and put back in its answers, so they never reach Anthropic or OpenAI while your resume still shows them. The setup wizard asks for your name before reading your CV; Settings shows exactly what the AI receives. Your contact block is no longer sent to the AI at all.
+- **Backup and restore** (Settings → Backup & restore, or `tailorbirdcv backup` / `tailorbirdcv restore`): your whole profile, memory, applications (with what you sent), settings and history as one .zip, and restore on another computer straight from the setup wizard's first page. API keys are included only if you tick the box. Restoring checks the file first and never deletes anything: the data it replaces is kept in `before-restore/`. Every backup warns that the file isn't encrypted and must be kept safe.
+- **Resumes fit their page limit reliably.** The length estimate now lays the resume out the way Word does (real font widths and line heights, spacing, page breaks), so a 1-page resume no longer spills onto a second page and a 2-page resume fills its second page (about 85–95% instead of 70–80%). Corrections learned from earlier builds start over. No resume text is smaller than 9.5 pt any more (Classic at the Standard size keeps its original 8.5 pt contact line and dates); a contact line too long for one line wraps between items. A Word conversion that fails with "Message not understood" is retried once.
+- **A friendlier wait:** while the AI works, the tailorbird hops along its leaf sewing the stitch; while documents are built, the stitch runs around a page. With the system's *reduce motion* setting on, the stitch still sews but the bird stands still.
+- **AutoCV is now TailorbirdCV**, with a new logo and colours. The PyPI package and the command are both `tailorbirdcv` (`tailorbirdcv serve`), environment variables start with `TAILORBIRDCV_`, and the repository is github.com/atenreiro/tailorbirdcv. API keys saved in the keychain under the old name move over the first time they're used.
+- **Company icons:** applications made from a job link show the company's site icon on the board, in the table and in the detail panel, fetched once from the company's own website (never a job board's logo). SVG icons work too, and sites that block plain requests are read through the headless browser when it's installed. Without one, nothing changes. Settings → Applications → Show company icons turns them off (and stops fetching).
+- **Fixes from an architecture review:** marking an application applied or freezing a copy while it builds no longer hangs TailorbirdCV (lock order and the server loop); a draft that fails the fact-check no longer makes compose fail with an error; Claude Code is checked before every AI call and never used on a pay-per-use login (Console, Bedrock, Vertex); the private link only ever redirects within TailorbirdCV; the request log masks the link's key.
+- **Updates:** TailorbirdCV tells you when a new version is out, and copies installed with the one-line installer upgrade with one click: it downloads the new version, restarts on the same port and the page reloads. It asks PyPI for the latest version at most once a day; Settings → About TailorbirdCV shows the version and turns checks off. The version now lives in a `VERSION` file, and bumping it on main publishes the release automatically once CI passes.
+- The optional headless browser installs only Chromium's headless shell, the part TailorbirdCV uses: about 200 MB instead of 550 MB. The setup wizard no longer leaves an empty `setup/` folder behind.
+- **Identify a PDF** (Applications): drop in any resume PDF to see which application it came from: the exact file sent (SHA-256), the same PDF re-saved by another app (its document id), or the closest text. Sent copies record each file's SHA-256, shown under *Sent copies* in Export. Nothing is added to your PDFs.
+- **Runs on macOS, Windows and Linux.** Word is driven hidden on macOS (AppleScript) and Windows (COM); LibreOffice works everywhere, with metric-compatible stand-ins (Gelasio, Carlito) when Microsoft's fonts are missing, so page breaks match Word's.
+- **Choose the PDF engine** (Word or LibreOffice) in the new Settings page; Word is the default when both are installed.
+- **One-command install:** `curl -LsSf …/install.sh | sh` on macOS and Linux, `irm …/install.ps1 | iex` on Windows: the installer sets up uv if needed, installs `tailorbirdcv` from PyPI on a uv-managed Python 3.13 (never the system's or Homebrew's), puts `tailorbirdcv` on the PATH and starts TailorbirdCV, with no administrator rights; it trusts the system's certificates (company proxies), refuses to update or remove a running TailorbirdCV and to run under sudo, and says when uv is too old. Running it again updates. Or directly `uv tool install tailorbirdcv` (or `pipx install tailorbirdcv`). The web UI ships inside the package, so Node isn't needed. User data lives in the OS's per-user data folder.
+- `tailorbirdcv doctor` (also under Settings → System check) explains what's missing and how to fix it; `tailorbirdcv install-browser` installs the optional headless browser.
+- The fact-check's word list is bundled, so it behaves identically on every OS.
+- **Works for anyone:** a Welcome page imports any resume (.docx, PDF or text) through the AI, word-for-word, flagging anything that doesn't match the original; or start blank. Settings → *Your targets* (field, seniority, target roles, region, US/UK spelling, 1–3 page limit, domain pack) replaces the built-in cybersecurity/APAC assumptions; the original emphasis lives on as the *Cybersecurity* pack.
+- **Resume themes**: Classic (the original design, unchanged), Modern and Compact, on US Letter or A4 (Settings → Resume design). Length estimates follow the theme and paper.
+- **Setup wizard** on first run: connect Claude, upload your CV, review every line (anything not word-for-word in your file must be fixed, removed or confirmed; the server checks again), targets suggested from your CV, design, and final checks with a one-click headless-browser install. Progress and the imported draft survive a refresh.
+- Robustness: Windows Word conversions take paths via environment variables, report errors as plain text and stop the Word instance they started on a timeout; Carlito ships with TailorbirdCV (Calibri stand-in on Linux); a re-created profile never reuses old ids; Word's lock file survives rebuilds; the CLI reports PDF failures with exit code 3 instead of a traceback; the release workflow runs the tests first, and CI covers Python 3.11.
+- **Choice of AI engine** (Settings → AI engine): Claude Code on your subscription, or an Anthropic API key (pay per use), stored in the OS keychain. Switching takes effect immediately; *Test* checks it.
+- **Resumes fill their pages better.** The length budget is what your page limit actually holds in the chosen design (it used to follow your original resume's length, which left Compact resumes a sixth short). Every PDF build is measured, and TailorbirdCV learns how many lines each design really fits. Export shows how full the last page is, and *Fill the page with AI* proposes relevant evidence you haven't used yet, fact-checked, for you to review. Headings never end up alone at the bottom of a page.
+- **Add roles in Master profile → Experience**: company, location, dates, title, a scope line and 1–10 resume bullets. New roles get ids from the company name (`acme-bank`, `acme-bank.a1`…), never a retired one; roles can be reordered (↑ ↓) and deleted, and a role without a scope line can get one.
+- **More AI engines** (Settings → AI engine, and the setup wizard's *Connect your AI*): Codex on your ChatGPT subscription, an OpenAI API key, or an OpenRouter key (the same Claude model by default, routed to zero-data-retention providers). Schemas are sent in OpenAI's strict form; every answer is still validated and fact-checked. Each provider's key has its own keychain entry. Windows: reads no longer fail when they race a save.
+- **Setup checks this computer first** (new step *Your computer*): what you have and what you need — every AI option (installed, logged in, key saved), PDF engine with a one-click *Test PDF*, keychain, headless browser (exact version, with *Install*), Node.js — marked required, recommended or optional, re-checking itself as you install. *Connect your AI* can send one real test request. Claude Code and Codex installed after TailorbirdCV started are found without a restart.
+- **Stricter never-invent checks:** leadership, ownership, credential and scope words in any form; numbers kept with what they count; titles kept with their employer; product names that are also words; stricter import verification (decimals, symbols, each role in its own part of the CV). Fill and trim can only add or only remove.
+- **Privacy and security:** TailorbirdCV opens through a private link and only answers that browser; the data folder is owner-only; fonts ship with the app (no Google Fonts); job pages render in a sandboxed browser without WebRTC.
+- **Setup on macOS and Windows:** Claude Code installed with npm on Windows works again (its package now ships claude.exe); CLIs and Node installed after TailorbirdCV started (Homebrew, nvm, fnm, pnpm, Volta, WinGet, Scoop) are found and run with Node on their PATH; Claude Code counts as ready only on a subscription login; `tailorbirdcv serve` claims its port before opening its private link; keychain prompts never freeze the server and a locked keychain says so; Word's Test PDF explains the hidden prompts, macOS Automation permission, and offers LibreOffice when it fails; a hung Word on Windows is cleaned up; .rtf/.doc/.odt CVs are read on macOS, .txt in any common encoding; per-OS install commands and environment-variable syntax.
+- **Text size** (Settings → Resume design): *Comfortable* (the default) makes body text 1 pt larger — 10.5 pt in Classic and Modern — for easier reading; *Standard* keeps each design as drawn (Classic byte-for-byte). Length budgets, page measurements and Fill follow the size.
+- Output files keep accented and non-Latin names (José → `Jose_…`, not `Jos_…`).
+
+## 0.1.0 (not published)
+- First version: fact-locked tailoring, gap questions, memory, hiring-manager review, sent copies and history.

tailorbirdcv-0.2.0/PKG-INFO

@@ -0,0 +1,188 @@
+Metadata-Version: 2.5
+Name: tailorbirdcv
+Version: 0.2.0
+Summary: Tailor your resume to a job description without inventing anything — a local web app
+Project-URL: Homepage, https://github.com/atenreiro/tailorbirdcv
+Project-URL: Changelog, https://github.com/atenreiro/tailorbirdcv/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/atenreiro/tailorbirdcv/issues
+Keywords: ats,claude,cv,job application,openai,openrouter,resume
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business
+Requires-Python: >=3.11
+Requires-Dist: anthropic>=1.11
+Requires-Dist: beautifulsoup4>=4.12
+Requires-Dist: fastapi>=0.115
+Requires-Dist: httpx>=0.27
+Requires-Dist: keyring>=25
+Requires-Dist: openai>=3.24
+Requires-Dist: platformdirs>=4.0
+Requires-Dist: playwright>=1.48
+Requires-Dist: pydantic>=2.6
+Requires-Dist: pypdf>=4.0
+Requires-Dist: python-docx>=1.1
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: truststore>=0.10
+Requires-Dist: uvicorn>=0.30
+Description-Content-Type: text/markdown
+
+<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/atenreiro/tailorbirdcv/v0.2.0/docs/logo-dark.png"><img src="https://raw.githubusercontent.com/atenreiro/tailorbirdcv/v0.2.0/docs/logo.png" alt="TailorbirdCV" width="420"></picture></p>
+
+# TailorbirdCV
+
+**Tailor your resume to each job, without inventing anything.**
+
+Give TailorbirdCV your CV once. Then, for each job, paste the posting's link. TailorbirdCV:
+- works out what the role cares about;
+- asks you about anything the job wants that your CV doesn't show;
+- writes a tailored resume from your real experience (and a cover letter, if you want one);
+- builds a Word document and a PDF, ready to send.
+
+A built-in fact-check makes sure every line comes from your own CV: no made-up numbers, tools, employers or claims. Your name, employers, job titles, dates and education are copied exactly.
+
+TailorbirdCV runs on your own computer (macOS, Windows or Linux) and opens in your browser. The writing is done by the AI you choose.
+
+![A tailored resume in Review: every line traces back to the profile, and the fact-check has passed](https://raw.githubusercontent.com/atenreiro/tailorbirdcv/v0.2.0/docs/screenshots/review.png)
+
+## How it works
+<picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/atenreiro/tailorbirdcv/v0.2.0/docs/how-it-works-dark.png"><img src="https://raw.githubusercontent.com/atenreiro/tailorbirdcv/v0.2.0/docs/how-it-works.png" alt="How TailorbirdCV works. You give it your CV once, then a job posting and your answers to its questions. On your computer, TailorbirdCV keeps your master profile (the only source of facts), reads the job, asks about gaps, writes a draft, fact-checks every line against your profile and builds a Word document and PDF of your tailored resume and cover letter. The AI you choose (Claude or ChatGPT with your subscription, or an API key from Anthropic, OpenAI or OpenRouter) sees only the job and your CV's content; Privacy mode (optional and experimental) replaces your name, email, phone and links with placeholders before anything is sent."></picture>
+
+Everything except the AI runs on your computer. Your CV becomes your **master profile**, the only place facts come from. The AI reads the job and writes the draft; TailorbirdCV checks every line against your profile before you see it.
+
+## What you need
+1. **An AI**, any one of:
+   - a **Claude** subscription, with [Claude Code](https://claude.com/claude-code) installed and logged in. No extra cost;
+   - a **ChatGPT** subscription, with [Codex](https://github.com/openai/codex) installed and logged in. No extra cost;
+   - an **API key** from [Anthropic](https://console.anthropic.com/), [OpenAI](https://platform.openai.com/) or [OpenRouter](https://openrouter.ai/), paid per use. It's kept in your computer's keychain.
+2. **Something to make PDFs**: Microsoft Word, or the free [LibreOffice](https://www.libreoffice.org/). Without either, you still get the Word document.
+
+Not sure what you have? Install TailorbirdCV first: its setup wizard checks and shows how to add anything missing.
+
+## Install
+**macOS or Linux:** open **Terminal**, paste this line and press Return:
+```bash
+curl -LsSf https://raw.githubusercontent.com/atenreiro/tailorbirdcv/main/install.sh | sh
+```
+
+**Windows:** open **PowerShell** (a normal window, not as administrator), paste this line and press Enter:
+```powershell
+irm https://raw.githubusercontent.com/atenreiro/tailorbirdcv/main/install.ps1 | iex
+```
+
+After a minute or two, TailorbirdCV opens in your browser. Keep the Terminal or PowerShell window open while you use it.
+
+<details>
+<summary>What the installer does</summary>
+
+The scripts are short enough to read first: [install.sh](https://github.com/atenreiro/tailorbirdcv/blob/main/install.sh) and [install.ps1](https://github.com/atenreiro/tailorbirdcv/blob/main/install.ps1). They:
+- install [uv](https://docs.astral.sh/uv/) (Astral's open-source Python installer) if you don't have it;
+- install TailorbirdCV from PyPI in its own environment, with its own Python 3.13. Any Python already on your computer is left alone;
+- add the `tailorbirdcv` command and start it.
+
+They need no administrator rights, write only inside your user folder, and use your computer's own certificates, so they also work on company networks that inspect HTTPS.
+
+Prefer to do it yourself? Install uv (`brew install uv`, `winget install astral-sh.uv`, or [another way](https://docs.astral.sh/uv/getting-started/installation/)), open a new terminal, then run `uv tool install --python 3.13 tailorbirdcv` and `tailorbirdcv serve`.
+</details>
+
+## Start, stop and update
+- **Start:** run `tailorbirdcv serve` in Terminal or PowerShell. Your browser opens TailorbirdCV through a private link (also printed in the terminal) that unlocks it in that browser only.
+- **Stop:** press **Ctrl+C** in that window, or close it.
+- **Update:** when a new version is out, TailorbirdCV says so at the top of the page. Click **Upgrade** and it restarts by itself. To know, it asks PyPI for the latest version number at most once a day; nothing about you is sent. You can turn this off in **Settings → About TailorbirdCV**.
+- **Check your setup:** `tailorbirdcv doctor`.
+
+<details>
+<summary>Uninstall</summary>
+
+Stop TailorbirdCV, then run:
+- macOS or Linux:
+  ```bash
+  curl -LsSf https://raw.githubusercontent.com/atenreiro/tailorbirdcv/main/install.sh | sh -s -- --uninstall
+  ```
+- Windows:
+  ```powershell
+  $env:TAILORBIRDCV_UNINSTALL = "1"; irm https://raw.githubusercontent.com/atenreiro/tailorbirdcv/main/install.ps1 | iex
+  ```
+
+`uv tool uninstall tailorbirdcv` does the same. Your profile and applications stay in your [data folder](#your-data-and-privacy) until you delete it. uv stays installed; [Astral explains how to remove it](https://docs.astral.sh/uv/getting-started/installation/#uninstallation).
+</details>
+
+## First run
+A short setup wizard (about 5 minutes) checks your computer, connects your AI, reads your CV, then asks about your targets (field, seniority, region, spelling, page limit) and a design (Classic, Modern or Compact).
+
+Your CV is copied word for word, never rewritten. Nothing is saved until you've checked it: any line that doesn't match your file exactly is highlighted for you to fix or confirm.
+
+Moving from another computer? Choose **Restore from a backup** on the wizard's first page.
+
+![The setup wizard's review step: the CV as TailorbirdCV read it, checked line by line against the file](https://raw.githubusercontent.com/atenreiro/tailorbirdcv/v0.2.0/docs/screenshots/setup.png)
+
+## Tailoring a resume
+1. Click **New tailoring** and paste the job posting's link (or its text).
+2. **Brief:** see what the role wants and how your experience matches.
+3. **Gaps:** answer questions about what the job wants and your profile doesn't show. No experience? Say so: it stays a gap.
+4. **Review:** read the draft, click any line to edit it, and optionally ask for a hiring-manager review.
+5. **Cover letter** (optional): one page in the same design, in a Formal, Warm or Direct tone, checked sentence by sentence like your resume.
+6. **Export:** build the Word document and PDF. Too long? **Trim with AI**. Room to spare? **Fill the page with AI**. Both show their suggestions in Review before anything changes.
+
+Then track it under **Applications**. Marking an application *applied* keeps a read-only copy of exactly what you sent. Found one of your resumes and not sure which version it is? **Identify a PDF** tells you which application it came from.
+
+![The brief: what the role wants, and how your evidence stacks up against each requirement](https://raw.githubusercontent.com/atenreiro/tailorbirdcv/v0.2.0/docs/screenshots/brief.png)
+
+![Gap questions: TailorbirdCV asks about what the job wants and your profile doesn't show](https://raw.githubusercontent.com/atenreiro/tailorbirdcv/v0.2.0/docs/screenshots/gaps.png)
+
+The screenshots use a fictional profile and job posting.
+
+## Your data and privacy
+> [!IMPORTANT]
+> **The only thing that leaves your computer is what the AI needs to read your CV and the job, and to write the resume.**
+
+There's no account, no server and no tracking. Your profile, applications and settings are kept in:
+- macOS: `~/Library/Application Support/TailorbirdCV`
+- Windows: `%LOCALAPPDATA%\TailorbirdCV`
+- Linux: `~/.local/share/TailorbirdCV`
+
+**Privacy mode** (on by default, **experimental**): your name, email, phone, address and personal links are replaced with placeholders like `[NAME]` before anything is sent to the AI, and put back afterwards, so your resume still shows them. Your career history is still sent and can identify you, and an unusual spelling can slip through, so use it with care. **Settings → Privacy → See what the AI receives** shows exactly what is sent.
+
+**Company icons:** for applications made from a job link, TailorbirdCV fetches the company's icon once, from the company's own website. Turn this off in **Settings → Applications**.
+
+### Backup and restore
+Everything lives only on your computer, so keep a backup: **Settings → Backup & restore → Download backup** saves it all as one `.zip`. Restore it on any computer from the same page, or from the setup wizard's first page. Restoring never deletes anything: the data it replaces is kept in a `before-restore` folder. From a terminal: `tailorbirdcv backup [file]` and `tailorbirdcv restore <file>`.
+
+> [!WARNING]
+> **A backup isn't encrypted.** Anyone with the file can read your CV, contact details and applications, and use your API keys if you chose to include them (they're left out unless you tick **Include my API keys**). Keep it somewhere private and don't share it.
+
+## If something goes wrong
+| What you see | What to do |
+|---|---|
+| `command not found: tailorbirdcv`, or *tailorbirdcv is not recognized* | Open a new Terminal or PowerShell window. Still not found? Run `uv tool update-shell`, then open another new window. |
+| *TailorbirdCV is running. Stop it first* | Press Ctrl+C in the window where TailorbirdCV runs (or close it), then run the installer again. |
+| *Port 8000 is already in use* | TailorbirdCV is already running: use the link in its window, or start another copy with `tailorbirdcv serve --port 8001`. |
+| *Running scripts is disabled on this system* (Windows) | Use the `irm … \| iex` line above instead of a downloaded `install.ps1` file. |
+| *Don't run this with sudo* (macOS, Linux) | Run the install line again without `sudo`: TailorbirdCV installs for your user only. |
+| Downloads fail or time out | Your network may block astral.sh, GitHub or PyPI. Try another network, or ask your IT team to allow them. |
+| Anything else | Run `tailorbirdcv doctor`: it checks your AI, PDF engine and fonts, and says how to fix what's missing. |
+
+## For developers
+To run TailorbirdCV from a copy of this repository you'll also need [Node.js](https://nodejs.org/), to build the interface once:
+```bash
+uv sync
+npm --prefix web install && npm --prefix web run build
+uv run tailorbirdcv serve
+```
+A copy of the repository keeps your data in its `private/` folder (never committed). To use any other folder, set `TAILORBIRDCV_PRIVATE` to its path.
+
+```bash
+uv run pytest                                        # tests
+npm --prefix web run dev                             # interface with live reload (port 5173)
+TAILORBIRDCV_ENGINE=fake uv run tailorbirdcv serve --port 8001   # demo mode, no AI calls
+```
+To release a new version: change the number in [VERSION](https://github.com/atenreiro/tailorbirdcv/blob/main/VERSION) (and add a CHANGELOG entry), then push to `main` (automatic releases are on once the repository variable `RELEASES_ENABLED` is `true`). Once CI passes, the release workflow publishes that version to PyPI and tags it, and installed copies offer the upgrade within a day.
+
+The rules TailorbirdCV follows and how the code is laid out are described in [CLAUDE.md](https://github.com/atenreiro/tailorbirdcv/blob/main/CLAUDE.md). Changes are listed in [CHANGELOG.md](https://github.com/atenreiro/tailorbirdcv/blob/main/CHANGELOG.md).

tailorbirdcv-0.2.0/README.md

@@ -0,0 +1,152 @@
+<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/atenreiro/tailorbirdcv/v0.2.0/docs/logo-dark.png"><img src="https://raw.githubusercontent.com/atenreiro/tailorbirdcv/v0.2.0/docs/logo.png" alt="TailorbirdCV" width="420"></picture></p>
+
+# TailorbirdCV
+
+**Tailor your resume to each job, without inventing anything.**
+
+Give TailorbirdCV your CV once. Then, for each job, paste the posting's link. TailorbirdCV:
+- works out what the role cares about;
+- asks you about anything the job wants that your CV doesn't show;
+- writes a tailored resume from your real experience (and a cover letter, if you want one);
+- builds a Word document and a PDF, ready to send.
+
+A built-in fact-check makes sure every line comes from your own CV: no made-up numbers, tools, employers or claims. Your name, employers, job titles, dates and education are copied exactly.
+
+TailorbirdCV runs on your own computer (macOS, Windows or Linux) and opens in your browser. The writing is done by the AI you choose.
+
+![A tailored resume in Review: every line traces back to the profile, and the fact-check has passed](https://raw.githubusercontent.com/atenreiro/tailorbirdcv/v0.2.0/docs/screenshots/review.png)
+
+## How it works
+<picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/atenreiro/tailorbirdcv/v0.2.0/docs/how-it-works-dark.png"><img src="https://raw.githubusercontent.com/atenreiro/tailorbirdcv/v0.2.0/docs/how-it-works.png" alt="How TailorbirdCV works. You give it your CV once, then a job posting and your answers to its questions. On your computer, TailorbirdCV keeps your master profile (the only source of facts), reads the job, asks about gaps, writes a draft, fact-checks every line against your profile and builds a Word document and PDF of your tailored resume and cover letter. The AI you choose (Claude or ChatGPT with your subscription, or an API key from Anthropic, OpenAI or OpenRouter) sees only the job and your CV's content; Privacy mode (optional and experimental) replaces your name, email, phone and links with placeholders before anything is sent."></picture>
+
+Everything except the AI runs on your computer. Your CV becomes your **master profile**, the only place facts come from. The AI reads the job and writes the draft; TailorbirdCV checks every line against your profile before you see it.
+
+## What you need
+1. **An AI**, any one of:
+   - a **Claude** subscription, with [Claude Code](https://claude.com/claude-code) installed and logged in. No extra cost;
+   - a **ChatGPT** subscription, with [Codex](https://github.com/openai/codex) installed and logged in. No extra cost;
+   - an **API key** from [Anthropic](https://console.anthropic.com/), [OpenAI](https://platform.openai.com/) or [OpenRouter](https://openrouter.ai/), paid per use. It's kept in your computer's keychain.
+2. **Something to make PDFs**: Microsoft Word, or the free [LibreOffice](https://www.libreoffice.org/). Without either, you still get the Word document.
+
+Not sure what you have? Install TailorbirdCV first: its setup wizard checks and shows how to add anything missing.
+
+## Install
+**macOS or Linux:** open **Terminal**, paste this line and press Return:
+```bash
+curl -LsSf https://raw.githubusercontent.com/atenreiro/tailorbirdcv/main/install.sh | sh
+```
+
+**Windows:** open **PowerShell** (a normal window, not as administrator), paste this line and press Enter:
+```powershell
+irm https://raw.githubusercontent.com/atenreiro/tailorbirdcv/main/install.ps1 | iex
+```
+
+After a minute or two, TailorbirdCV opens in your browser. Keep the Terminal or PowerShell window open while you use it.
+
+<details>
+<summary>What the installer does</summary>
+
+The scripts are short enough to read first: [install.sh](https://github.com/atenreiro/tailorbirdcv/blob/main/install.sh) and [install.ps1](https://github.com/atenreiro/tailorbirdcv/blob/main/install.ps1). They:
+- install [uv](https://docs.astral.sh/uv/) (Astral's open-source Python installer) if you don't have it;
+- install TailorbirdCV from PyPI in its own environment, with its own Python 3.13. Any Python already on your computer is left alone;
+- add the `tailorbirdcv` command and start it.
+
+They need no administrator rights, write only inside your user folder, and use your computer's own certificates, so they also work on company networks that inspect HTTPS.
+
+Prefer to do it yourself? Install uv (`brew install uv`, `winget install astral-sh.uv`, or [another way](https://docs.astral.sh/uv/getting-started/installation/)), open a new terminal, then run `uv tool install --python 3.13 tailorbirdcv` and `tailorbirdcv serve`.
+</details>
+
+## Start, stop and update
+- **Start:** run `tailorbirdcv serve` in Terminal or PowerShell. Your browser opens TailorbirdCV through a private link (also printed in the terminal) that unlocks it in that browser only.
+- **Stop:** press **Ctrl+C** in that window, or close it.
+- **Update:** when a new version is out, TailorbirdCV says so at the top of the page. Click **Upgrade** and it restarts by itself. To know, it asks PyPI for the latest version number at most once a day; nothing about you is sent. You can turn this off in **Settings → About TailorbirdCV**.
+- **Check your setup:** `tailorbirdcv doctor`.
+
+<details>
+<summary>Uninstall</summary>
+
+Stop TailorbirdCV, then run:
+- macOS or Linux:
+  ```bash
+  curl -LsSf https://raw.githubusercontent.com/atenreiro/tailorbirdcv/main/install.sh | sh -s -- --uninstall
+  ```
+- Windows:
+  ```powershell
+  $env:TAILORBIRDCV_UNINSTALL = "1"; irm https://raw.githubusercontent.com/atenreiro/tailorbirdcv/main/install.ps1 | iex
+  ```
+
+`uv tool uninstall tailorbirdcv` does the same. Your profile and applications stay in your [data folder](#your-data-and-privacy) until you delete it. uv stays installed; [Astral explains how to remove it](https://docs.astral.sh/uv/getting-started/installation/#uninstallation).
+</details>
+
+## First run
+A short setup wizard (about 5 minutes) checks your computer, connects your AI, reads your CV, then asks about your targets (field, seniority, region, spelling, page limit) and a design (Classic, Modern or Compact).
+
+Your CV is copied word for word, never rewritten. Nothing is saved until you've checked it: any line that doesn't match your file exactly is highlighted for you to fix or confirm.
+
+Moving from another computer? Choose **Restore from a backup** on the wizard's first page.
+
+![The setup wizard's review step: the CV as TailorbirdCV read it, checked line by line against the file](https://raw.githubusercontent.com/atenreiro/tailorbirdcv/v0.2.0/docs/screenshots/setup.png)
+
+## Tailoring a resume
+1. Click **New tailoring** and paste the job posting's link (or its text).
+2. **Brief:** see what the role wants and how your experience matches.
+3. **Gaps:** answer questions about what the job wants and your profile doesn't show. No experience? Say so: it stays a gap.
+4. **Review:** read the draft, click any line to edit it, and optionally ask for a hiring-manager review.
+5. **Cover letter** (optional): one page in the same design, in a Formal, Warm or Direct tone, checked sentence by sentence like your resume.
+6. **Export:** build the Word document and PDF. Too long? **Trim with AI**. Room to spare? **Fill the page with AI**. Both show their suggestions in Review before anything changes.
+
+Then track it under **Applications**. Marking an application *applied* keeps a read-only copy of exactly what you sent. Found one of your resumes and not sure which version it is? **Identify a PDF** tells you which application it came from.
+
+![The brief: what the role wants, and how your evidence stacks up against each requirement](https://raw.githubusercontent.com/atenreiro/tailorbirdcv/v0.2.0/docs/screenshots/brief.png)
+
+![Gap questions: TailorbirdCV asks about what the job wants and your profile doesn't show](https://raw.githubusercontent.com/atenreiro/tailorbirdcv/v0.2.0/docs/screenshots/gaps.png)
+
+The screenshots use a fictional profile and job posting.
+
+## Your data and privacy
+> [!IMPORTANT]
+> **The only thing that leaves your computer is what the AI needs to read your CV and the job, and to write the resume.**
+
+There's no account, no server and no tracking. Your profile, applications and settings are kept in:
+- macOS: `~/Library/Application Support/TailorbirdCV`
+- Windows: `%LOCALAPPDATA%\TailorbirdCV`
+- Linux: `~/.local/share/TailorbirdCV`
+
+**Privacy mode** (on by default, **experimental**): your name, email, phone, address and personal links are replaced with placeholders like `[NAME]` before anything is sent to the AI, and put back afterwards, so your resume still shows them. Your career history is still sent and can identify you, and an unusual spelling can slip through, so use it with care. **Settings → Privacy → See what the AI receives** shows exactly what is sent.
+
+**Company icons:** for applications made from a job link, TailorbirdCV fetches the company's icon once, from the company's own website. Turn this off in **Settings → Applications**.
+
+### Backup and restore
+Everything lives only on your computer, so keep a backup: **Settings → Backup & restore → Download backup** saves it all as one `.zip`. Restore it on any computer from the same page, or from the setup wizard's first page. Restoring never deletes anything: the data it replaces is kept in a `before-restore` folder. From a terminal: `tailorbirdcv backup [file]` and `tailorbirdcv restore <file>`.
+
+> [!WARNING]
+> **A backup isn't encrypted.** Anyone with the file can read your CV, contact details and applications, and use your API keys if you chose to include them (they're left out unless you tick **Include my API keys**). Keep it somewhere private and don't share it.
+
+## If something goes wrong
+| What you see | What to do |
+|---|---|
+| `command not found: tailorbirdcv`, or *tailorbirdcv is not recognized* | Open a new Terminal or PowerShell window. Still not found? Run `uv tool update-shell`, then open another new window. |
+| *TailorbirdCV is running. Stop it first* | Press Ctrl+C in the window where TailorbirdCV runs (or close it), then run the installer again. |
+| *Port 8000 is already in use* | TailorbirdCV is already running: use the link in its window, or start another copy with `tailorbirdcv serve --port 8001`. |
+| *Running scripts is disabled on this system* (Windows) | Use the `irm … \| iex` line above instead of a downloaded `install.ps1` file. |
+| *Don't run this with sudo* (macOS, Linux) | Run the install line again without `sudo`: TailorbirdCV installs for your user only. |
+| Downloads fail or time out | Your network may block astral.sh, GitHub or PyPI. Try another network, or ask your IT team to allow them. |
+| Anything else | Run `tailorbirdcv doctor`: it checks your AI, PDF engine and fonts, and says how to fix what's missing. |
+
+## For developers
+To run TailorbirdCV from a copy of this repository you'll also need [Node.js](https://nodejs.org/), to build the interface once:
+```bash
+uv sync
+npm --prefix web install && npm --prefix web run build
+uv run tailorbirdcv serve
+```
+A copy of the repository keeps your data in its `private/` folder (never committed). To use any other folder, set `TAILORBIRDCV_PRIVATE` to its path.
+
+```bash
+uv run pytest                                        # tests
+npm --prefix web run dev                             # interface with live reload (port 5173)
+TAILORBIRDCV_ENGINE=fake uv run tailorbirdcv serve --port 8001   # demo mode, no AI calls
+```
+To release a new version: change the number in [VERSION](https://github.com/atenreiro/tailorbirdcv/blob/main/VERSION) (and add a CHANGELOG entry), then push to `main` (automatic releases are on once the repository variable `RELEASES_ENABLED` is `true`). Once CI passes, the release workflow publishes that version to PyPI and tags it, and installed copies offer the upgrade within a day.
+
+The rules TailorbirdCV follows and how the code is laid out are described in [CLAUDE.md](https://github.com/atenreiro/tailorbirdcv/blob/main/CLAUDE.md). Changes are listed in [CHANGELOG.md](https://github.com/atenreiro/tailorbirdcv/blob/main/CHANGELOG.md).

tailorbirdcv-0.2.0/VERSION

@@ -0,0 +1 @@
+0.2.0

tailorbirdcv-0.2.0/hatch_build.py

@@ -0,0 +1,19 @@
+"""Hatch build hook: ship the built web UI inside the wheel, so users don't need Node.
+
+`npm --prefix web ci && npm --prefix web run build` must run before `uv build` (the release
+workflow does). Editable/dev installs serve web/dist straight from the checkout instead.
+"""
+
+from pathlib import Path
+
+from hatchling.builders.hooks.plugin.interface import BuildHookInterface
+
+
+class CustomBuildHook(BuildHookInterface):
+    def initialize(self, version, build_data):
+        if self.target_name != "wheel" or version == "editable":
+            return
+        dist = Path(self.root) / "web" / "dist"
+        if not (dist / "index.html").is_file():
+            raise RuntimeError("web/dist is missing: run `npm --prefix web ci && npm --prefix web run build` first")
+        build_data["force_include"][str(dist)] = "tailorbirdcv/web"

tailorbirdcv-0.2.0/pyproject.toml

@@ -0,0 +1,71 @@
+[project]
+name = "tailorbirdcv"
+dynamic = ["version"]  # from the VERSION file: bump it on main and CI releases it (see release.yml)
+description = "Tailor your resume to a job description without inventing anything — a local web app"
+readme = "README.md"
+requires-python = ">=3.11"
+keywords = ["resume", "cv", "job application", "ats", "claude", "openai", "openrouter"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Web Environment",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: MacOS",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Office/Business",
+]
+dependencies = [
+    "python-docx>=1.1",
+    "pyyaml>=6.0",
+    "pydantic>=2.6",
+    "pypdf>=4.0",
+    "fastapi>=0.115",
+    "uvicorn>=0.30",
+    "httpx>=0.27",
+    "beautifulsoup4>=4.12",
+    "playwright>=1.48",
+    "platformdirs>=4.0",
+    "anthropic>=1.11",  # messages.create(output_config=…) structured outputs, as tested
+    "keyring>=25",
+    "openai>=3.24",  # Responses API with strict json_schema, as tested
+    "truststore>=0.10",  # update checks trust the OS certificates (company proxies that inspect HTTPS)
+]
+
+[project.scripts]
+tailorbirdcv = "tailorbirdcv.cli:main"  # also what `uvx tailorbirdcv` runs
+
+[project.urls]
+Homepage = "https://github.com/atenreiro/tailorbirdcv"
+Changelog = "https://github.com/atenreiro/tailorbirdcv/blob/main/CHANGELOG.md"
+Issues = "https://github.com/atenreiro/tailorbirdcv/issues"
+
+[dependency-groups]
+dev = ["pytest>=8"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+path = "VERSION"
+pattern = '^(?P<version>\d+\.\d+\.\d+)\s*$'
+
+[tool.hatch.build.targets.wheel]
+packages = ["tailorbirdcv"]
+
+[tool.hatch.build.targets.wheel.hooks.custom]
+path = "hatch_build.py"  # bundles the built web UI (web/dist) as tailorbirdcv/web
+
+[tool.hatch.build.targets.sdist]
+include = ["/tailorbirdcv", "/web/dist", "/README.md", "/CHANGELOG.md", "/hatch_build.py", "/VERSION"]  # anchored: nothing from node_modules or worktrees
+artifacts = ["/web/dist/**"]  # git-ignored, but the wheel built from the sdist needs it
+
+[tool.uv]
+cache-keys = [{ file = "pyproject.toml" }, { file = "VERSION" }]  # a VERSION bump refreshes the editable install's version
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

tailorbirdcv-0.2.0/tailorbirdcv/__init__.py

@@ -0,0 +1 @@
+"""TailorbirdCV — tailor a fact-locked master resume to a job description."""