jobfinder

A Streamlit-based job search application that scrapes and manages job listings using JobSpy, with AI-powered evaluation capabilities.

Coverage Report

File	Stmts	Miss	Cover	Missing
src/jobfinder
__init__.py	28	1	96%	14
bootstrap.py	52	15	71%	55–61, 72–83, 87
main.py	24	24	0%	1–43
session.py	93	26	72%	87, 92, 104–115, 119–125, 129, 133, 137–138, 144, 149–152, 163
src/jobfinder/adapters/chat
chat_client.py	31	9	71%	27, 31, 34–41
ollama_chat.py	27	3	89%	42–43, 47
src/jobfinder/adapters/db
postgres_client.py	178	36	80%	36–38, 55–57, 88–90, 123–125, 141, 143–145, 151–152, 167–169, 172–181, 208–210, 235–237
src/jobfinder/adapters/embedding
embedding_client.py	34	11	68%	17, 20–27, 44–46
src/jobfinder/domain
models.py	278	74	73%	38–40, 83–85, 156–158, 169–171, 174, 183–185, 192, 196, 201–203, 210, 213–217, 224, 227, 230–232, 242–246, 257–261, 267–270, 283–303, 347, 363–365, 369–379, 392, 399, 408–409
src/jobfinder/pages
listings_overview.py	10	1	90%	29
src/jobfinder/services
data_service.py	88	36	59%	17, 28–32, 40–42, 45–50, 63–65, 68–79, 84, 93–95, 105, 118–120
generative_service.py	83	54	35%	25–57, 69–70, 72–73, 81–86, 89–112
src/jobfinder/utils
__init__.py	7	1	86%	8
loader.py	33	5	85%	20, 33, 38–40
persistence.py	17	4	76%	53, 58–60
service_helpers.py	10	3	70%	12–14
src/jobfinder/views
common.py	41	3	93%	24–26
TOTAL	1068	306	71%

Features

Job Scraping: Automated job listing collection via JobSpy
Interactive UI: Streamlit interface for job search and management
AI-Powered Insights: Contextual scoring with OpenAI using engineered prompts from user evaluated records populated with Jinja templates.
Modern Tooling: Packaged with with uv
Continous Coverage: pytest for testing and coverage reporting

Semantic releases are defined using conventional commits and all changes will be found in the CHANGELOG

A detailed overview of the data augmentation process can be found in the Walkthrough document.

```bash

git clone cd jobfinder ```

To add additional configurations, create .env in root of repository directory.
To enable scoring using chat completions model, add to .env: OPENAI_KEY = {YOUR_KEY}
To set OpenAI chat completions model, add to .env: OPENAI_MODEL = {MODEL}

bash streamlit run main.py

```bash uv add --editable --dev jobfinder uv run main.py