How srijata613/talentiq works
TalentIQ is a recruiter-facing resume screening and talent intelligence application. Its principal documented workflow takes resumes and a job description, parses candidate data, ranks candidates using weighted skill, experience, education, and bonus scores, then returns explainable results for the web interface. The backend also exposes comparison, search, matching, shortlisting, interview, clustering, and duplicate-management capabilities. The README documents the frontend-to-API architecture; sampled source confirms the ranking endpoint’s parsing and ranking calls, but does not show frontend action wiring or the internals of the ranker.
Main entry points: main.py FastAPI App · ranker.py Candidate Ranker · app Hiring Interface · candidate_pipeline.py Candidate Processing
Components 23
Recruiter Interface
- Hiring Interface
frontend/app - UI Actions
frontend/actions
API Layer
- FastAPI App
backend/app/main.py - Job Routes
backend/app/routes/jobs.py - Matching Routes
backend/app/routes/matching.py - Search Route
backend/app/routes/search.py - Talent Routes
backend/app/routes
Ranking Intelligence
- Resume Parser
backend/src/resume_parser.py - LLM Parser
backend/src/llm/parser.py - Candidate Ranker
backend/src/ranker.py - Skill Scoring
backend/src/skill_scoring.py - Experience Scoring
backend/src/experience_scoring.py - Education And Bonus
backend/src/education_bonus.py - Embeddings
backend/src/embeddings.py
Talent Workflows
- Candidate Comparison
backend/src/comparison.py - Candidate Search
backend/src/search_engine.py - Semantic Retrieval
backend/src/retrieval_engine.py - Candidate Processing
backend/src/candidate_pipeline.py - Interview Planning
backend/src/interview_engine.py - Shortlisting
backend/src/shortlisting.py - Candidate Clustering
backend/src/candidate_clustering.py - Duplicate Resolution
backend/src/duplicate_resolution.py
Other components
- Recruiter
Connections 17
- Recruiter → Hiring Interface: uses
- Hiring Interface → UI Actions: initiates
- Hiring Interface → FastAPI App: uses API
- FastAPI App → Job Routes: mounts
- FastAPI App → Matching Routes: mounts
- FastAPI App → Search Route: mounts
- FastAPI App → Talent Routes: mounts
- FastAPI App → Resume Parser: parses resumes
- FastAPI App → Candidate Ranker: ranks candidates
- FastAPI App → Candidate Comparison: compares candidates
- Search Route → Candidate Search: calls
- Candidate Processing → LLM Parser: parses job
- Candidate Processing → Embeddings: builds candidate graph
- Semantic Retrieval → Embeddings: embeds query and profiles
- Candidate Ranker → Skill Scoring: scores skills
- Candidate Ranker → Experience Scoring: scores experience
- Candidate Ranker → Education And Bonus: scores education and bonus