feat: JobFinder — AI job search assistant powered by HrFlow.ai by Kenfack-franck · Pull Request #9 · Riminder/AppStore-public

Kenfack-franck · 2026-03-28T15:59:37Z

JobFinder

Team: Franck Ulrich Kenfack
Folder: kenfack-jobfinder
Type: Full-stack hiring agent

What it does

JobFinder is an AI-powered job search assistant that integrates HrFlow.ai deeply into a full-stack application (FastAPI + Next.js 14) to automate the entire job search process.

HrFlow.ai APIs used (10 endpoints)

API	Usage
`profile.parsing.add_file`	Parse PDF/DOCX CVs automatically
`profile.storing.add_json`	Index candidate profiles
`profile.storing.get`	Retrieve indexed profiles
`job.storing.add_json`	Index scraped job offers
`job.scoring.list`	Rank jobs by compatibility with profile
`job.searching.list`	Semantic search across job boards
`job.reasoning.get`	Explain match strengths & weaknesses
`text.tagging.post`	Extract skills from job descriptions
`text.embedding.post`	Vectorize text for similarity
`profile.asking.get` / `job.asking.get`	Natural language Q&A

Key features

Upload CV → HrFlow.ai extracts structured profile automatically
Personalized job feed ranked by HrFlow.ai compatibility score
AI chat (Claude) with HrFlow context for career coaching
Match explanation with strengths/weaknesses breakdown
Multi-source job scraping (RemoteOK, WTTJ, custom)
AI-generated personalized CVs and cover letters

Stack

Backend: Python 3.11, FastAPI, SQLAlchemy async, Celery
Frontend: Next.js 14, React 18, TypeScript, Tailwind CSS
AI: HrFlow.ai SDK v3.3 + Anthropic Claude haiku-4-5
Infrastructure: Docker Compose, PostgreSQL + pgvector, Redis

JobFinder is a full-stack application (FastAPI + Next.js) that uses HrFlow.ai for CV parsing, profile-job scoring, semantic search, match explanation, and skill extraction, combined with Claude AI for personalized career coaching and document generation. HrFlow.ai APIs used: - profile.parsing, profile.storing, job.storing - job.scoring, job.searching, job.reasoning - text.tagging, text.embedding - profile.asking, job.asking Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Copilot

Pull request overview

Adds a new App Store submission folder for JobFinder, providing the required manifest, environment-variable template, and documentation/preview asset for the HrFlow.ai hackathon catalog.

Changes:

Added kenfack-jobfinder/app.json app manifest for JobFinder.
Added kenfack-jobfinder/README.md describing features, architecture, and setup.
Added kenfack-jobfinder/.env.example plus assets/preview.png (and .gitkeep) for required submission artifacts.

Reviewed changes

Copilot reviewed 3 out of 5 changed files in this pull request and generated 4 comments.

File	Description
kenfack-jobfinder/app.json	Adds the app manifest (name/description/credentials/settings) for schema validation.
kenfack-jobfinder/README.md	Adds end-user documentation for what JobFinder is and how to run it.
kenfack-jobfinder/.env.example	Documents required environment variables with placeholder values.
kenfack-jobfinder/assets/.gitkeep	Keeps the assets directory tracked (alongside the preview image).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-03-28T16:03:13Z

kenfack-jobfinder/README.md

+│   ├── app/
+│   │   ├── api/            # FastAPI route handlers
+│   │   ├── services/       # Business logic
+│   │   │   ├── hrflow_service.py     # HrFlow.ai wrapper (all 11 APIs)


The README claims hrflow_service.py is a wrapper for “all 11 APIs”, but the feature table above enumerates 10 HrFlow.ai endpoints. Please reconcile the count (either update the claim to 10, or document the missing endpoint) to keep the integration documentation consistent.

Suggested change

│ │ │ ├── hrflow_service.py # HrFlow.ai wrapper (all 11 APIs)

│ │ │ ├── hrflow_service.py # HrFlow.ai wrapper (all 10 APIs)

Copilot · 2026-03-28T16:03:14Z

kenfack-jobfinder/README.md

+### 1. Clone the repository
+
+```bash
+git clone https://github.com/kenfackfranck08/hackaton_hrflow.git
+cd hackaton_hrflow
+```


The Quick Start clone instructions point to a different repository (kenfackfranck08/hackaton_hrflow) and cd hackaton_hrflow, which doesn’t match this AppStore submission folder. Please update the README to either (a) explain how to run the app from within kenfack-jobfinder/ in this repo, or (b) clearly state that the runnable code is hosted elsewhere and link to it, while keeping this README accurate for this submission.

Copilot · 2026-03-28T16:03:14Z

kenfack-jobfinder/README.md

+### 3. Start the application
+
+**Development:**
+```bash
+docker-compose up -d
+```
+
+**Production:**
+```bash
+docker-compose -f docker-compose.prod.yml up -d
+```
+
+### 4. Initialize the database
+
+```bash
+docker-compose exec backend alembic upgrade head
+```


The README instructs running docker-compose (including docker-compose.prod.yml) and docker-compose exec backend ..., but those compose files and the backend service aren’t present in this submission folder. Either add the referenced runtime files/services under kenfack-jobfinder/ or adjust the run instructions to match what’s actually included here.

Copilot · 2026-03-28T16:03:14Z

kenfack-jobfinder/README.md

+├── frontend/
+│   ├── src/
+│   │   ├── app/            # Next.js App Router pages
+│   │   │   ├── chat/       # AI chat interface
+│   │   │   ├── jobs/       # Job search & management
+│   │   │   ├── profile/    # Profile management
+│   │   │   └── dashboard/  # Personalized feed
+│   │   └── components/
+│   └── package.json
+├── docker-compose.yml
+├── docker-compose.prod.yml
+└── .env.example


The “Project Structure” section lists a hackaton_hrflow/ tree (backend/, frontend/, docker-compose files, etc.) that is not present in this repository under kenfack-jobfinder/. This is likely to confuse reviewers/users; please update the structure diagram to reflect the actual layout of this submission (or add the missing folders/files if they’re intended to be part of the PR).

Suggested change

├── frontend/

│ ├── src/

│ │ ├── app/ # Next.js App Router pages

│ │ │ ├── chat/ # AI chat interface

│ │ │ ├── jobs/ # Job search & management

│ │ │ ├── profile/ # Profile management

│ │ │ └── dashboard/ # Personalized feed

│ │ └── components/

│ └── package.json

├── docker-compose.yml

├── docker-compose.prod.yml

└── .env.example

└── ...

Copilot AI review requested due to automatic review settings March 28, 2026 15:59

Copilot started reviewing on behalf of Kenfack-franck March 28, 2026 16:00 View session

mnouayti merged commit e9868fa into Riminder:master Mar 28, 2026
4 checks passed

Copilot AI reviewed Mar 28, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: JobFinder — AI job search assistant powered by HrFlow.ai#9

feat: JobFinder — AI job search assistant powered by HrFlow.ai#9
mnouayti merged 1 commit intoRiminder:masterfrom
Kenfack-franck:team/kenfack-jobfinder

Kenfack-franck commented Mar 28, 2026

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Mar 28, 2026

Uh oh!

Copilot AI Mar 28, 2026

Uh oh!

Copilot AI Mar 28, 2026

Uh oh!

Copilot AI Mar 28, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

	│ │ │ ├── hrflow_service.py # HrFlow.ai wrapper (all 11 APIs)
	│ │ │ ├── hrflow_service.py # HrFlow.ai wrapper (all 10 APIs)

Conversation

Kenfack-franck commented Mar 28, 2026

JobFinder

What it does

HrFlow.ai APIs used (10 endpoints)

Key features

Stack

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Mar 28, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 28, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 28, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 28, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants