Spaces:
Running
Running
| title: Automated CV Parser | |
| emoji: 🧩 | |
| colorFrom: indigo | |
| colorTo: blue | |
| sdk: docker | |
| app_port: 7860 | |
| pinned: false | |
| short_description: Resume NER — extracts Job Titles, Skills & Education | |
| # CV Parser Dashboard | |
| A Streamlit app on top of the WQF7007 resume-NER model. Deployed as a Hugging | |
| Face Space; the model is loaded from the Hub so it can be updated without a | |
| redeploy. | |
| - **🔎 Live Parser** — paste/upload one CV and watch it get tokenized and | |
| classified: sub-word token chips coloured by predicted label, the original text | |
| with highlighted entities, and a structured summary. | |
| - **📊 Analytics** — batch-upload CVs (PDF / DOCX / TXT) for a skills word cloud | |
| and top-entity charts across the set. | |
| - **🔐 Manage Model** — password-gated; teammates upload a new exported model and | |
| it's pushed to the Hub repo the app reads from. | |
| ## Models — how swapping works | |
| The app loads its model **from a Hugging Face Hub repo** (`PRIMARY_MODEL_ID` in | |
| `config.py`, default `Zeqhx/cv-parser-ner`). A Space's own disk is wiped on | |
| restart, so the Hub repo is the durable store. To update the live model: | |
| - **Easiest:** open **Manage Model**, enter the page password, upload a `.zip` of | |
| your exported model folder (the `exported_models/…` folder the training notebooks | |
| produce). It's validated against the 7-tag scheme and pushed to the Hub repo. | |
| - **Or:** push files straight to the Hub model repo (web UI / CLI). | |
| - Then click **🔄 Reload model** in the sidebar to pick up the new weights. | |
| The sidebar picker also has a **Custom HF model ID** box to load any repo live. | |
| ## Secrets (Space → Settings → Variables and secrets) | |
| | Name | Purpose | | |
| |------|---------| | |
| | `HF_TOKEN` | A Hugging Face **write** token, so Manage Model can push to the Hub. | | |
| | `MANAGE_PASSWORD` | Password protecting the Manage Model page (page is disabled if unset). | | |
| | `DASHBOARD_MODEL_ID` | *(optional)* Override the model repo the app loads. | | |
| ## Run locally | |
| ```bash | |
| pip install -r requirements.txt | |
| streamlit run app.py | |
| ``` | |
| Local exported models in `../exported_models/…` are auto-offered in the picker | |
| when present (see `config.MODEL_REGISTRY`). | |
| ## Layout | |
| ``` | |
| app.py # landing page + model-status banner | |
| config.py # model registry/resolution, labels, colours, sample CV | |
| pages/ | |
| 1_Live_Parser.py | |
| 2_Analytics.py | |
| 3_Manage_Model.py # password-gated model uploader -> Hub | |
| lib/ | |
| model.py # load (local/Hub/fallback) + sliding-window inference | |
| extract.py # PDF / DOCX / TXT -> text (adaptive spacing fix) | |
| ui.py # shared sidebar model picker | |
| viz.py # entity HTML, token chips, word cloud, bar charts | |
| ``` | |