Spaces:
Sleeping
Sleeping
File size: 2,250 Bytes
fc547f6 7d3204c fc547f6 b5cb75b da0c238 b067322 da0c238 676f972 da0c238 7094b38 da0c238 7094b38 da0c238 b067322 da0c238 40f0b0a 7094b38 40f0b0a da0c238 b5cb75b da0c238 7094b38 da0c238 b067322 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 | ---
title: Smart Resume Builder
emoji: 📄
colorFrom: gray
colorTo: blue
sdk: gradio
sdk_version: "4.44.1"
app_file: app.py
pinned: false
license: mit
---
# Smart Resume Builder
Generate grounded, tailored resumes from a job description and a PDF resume using Gradio, OpenAI or Hugging Face models, and LaTeX templates. Suitable for local runs or Hugging Face Spaces.
## Features
- PDF parsing with `pdfplumber` and `pymupdf` fallback
- Strict, evidence-backed JSON extraction via OpenAI or Hugging Face router (OpenAI-compatible)
- Tailoring step that rewrites bullets without fabrication and reports missing items
- Two LaTeX templates (modern single-column and classic two-column)
- Streamlit UI with API key storage (keyring preferred), template selector, and export buttons
- Keyword alignment and missing/needs-confirmation panel
## Quickstart (local with uv)
```bash
# install uv if needed: curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv .venv
uv pip install -r requirements.txt
uv run app.py
```
## Using the app
1. Paste the job description.
2. Upload a resume PDF.
3. Pick a provider and enter your API key/token (optionally save it locally; system keychain is used when available).
4. Choose a model name and LaTeX template.
5. Click **Generate Tailored Resume**.
6. Review the LaTeX preview, missing/needs-confirmation list, and keyword alignment.
7. Export `.tex` or PDF. PDF export requires `latexmk`.
## Docker
```bash
make docker-build
make docker-run PORT=7860
```
Then open http://localhost:7860.
## LaTeX compilation
- PDF export uses `latexmk -pdf`. Install TeX Live or MikTeX and ensure `latexmk` is on your PATH.
- If `latexmk` is missing, PDF export is disabled but `.tex` export works.
## Security notes
- API keys are stored via `keyring` when available; otherwise a local fallback file `~/.smart_resume_builder_key` is used.
- Keys are never written to logs.
- Use the **Clear stored key** button to remove saved credentials.
## Tests
```bash
uv run pytest
```
## Troubleshooting
- Missing `latexmk`: install TeX Live/MikTeX.
- If PDF parsing is poor, ensure the resume PDF is text-based; image-only scans are harder to extract.
- For provider errors, verify the API key/token and model name in the UI.
|