How sagargwal/agenthire works
AgentHire is a FastAPI backend for company-aware job-description drafting and publishing. A recruiter authenticates, opens a chat session, and sends requests through the JD-builder API; a LangGraph agent gathers company and historical-JD context, presents it for confirmation, drafts and sanitizes a JD, then pauses for approval before publishing. Supporting branches provide authentication and public career-page reads. The README documents integrations and workflow stages not fully visible in the sampled source; the frontend and employee knowledge-entry workflow are not present in this tree.
Main entry points: tools.py Context and drafting tools · auth.py Auth endpoints · jd_builder.py JD chat API · graph.py Conversation graph
Components 21
API and identity
- FastAPI app
backend/main.py - Auth endpoints
backend/app/routers/auth.py - Token security
backend/app/core/security.py - Auth dependency
backend/app/core/auth_dependency.py - JD chat API
backend/app/routers/jd_builder.py - Careers endpoints
backend/app/routers/careers.py
JD agent workflow
- Conversation graph
backend/app/agents/jd_builder/graph.py - Conversation state
backend/app/agents/jd_builder/state.py - Context and drafting tools
backend/app/agents/jd_builder/tools.py
Company and JD data
- MySQL sessions
backend/app/core/database.py - User accounts
backend/app/models/user.py - Refresh tokens
backend/app/models/refresh_token.py - PostgreSQL sessions
backend/app/core/postgres_db.py - Company knowledge model
backend/app/models/nexus_company.py - Published JD records
backend/app/models/nexus_company.py
External services
- Redis memory
- Historical JD search
- GPT-4o
Other components
- Recruiter
- HR approval
- Careers page
Connections 25
- FastAPI app → Auth endpoints: registers routes
backend/main.py - FastAPI app → JD chat API: registers routes
backend/main.py - FastAPI app → Careers endpoints: registers routes
backend/main.py - Auth endpoints → MySQL sessions: queries accounts
backend/app/routers/auth.py - Auth endpoints → User accounts: reads and writes
backend/app/routers/auth.py - Auth endpoints → Refresh tokens: stores tokens
backend/app/routers/auth.py - Auth endpoints → Token security: creates tokens
backend/app/routers/auth.py - Auth dependency → Token security: decodes token
backend/app/core/auth_dependency.py - JD chat API → Auth dependency: requires identity
backend/app/routers/jd_builder.py - JD chat API → MySQL sessions: checks usage
backend/app/routers/jd_builder.py - JD chat API → User accounts: checks account
backend/app/routers/jd_builder.py - JD chat API → Conversation graph: invokes conversation
backend/app/routers/jd_builder.py - Conversation graph → Conversation state: uses state
backend/app/agents/jd_builder/graph.py - Conversation graph → Context and drafting tools: dispatches tools
backend/app/agents/jd_builder/graph.py - Conversation graph → Redis memory: persists sessions
README.md - Context and drafting tools → PostgreSQL sessions: queries company data
backend/app/agents/jd_builder/tools.py - Context and drafting tools → Company knowledge model: uses company schema
backend/app/agents/jd_builder/tools.py - Context and drafting tools → Historical JD search: searches precedent
README.md - Context and drafting tools → GPT-4o: generates JD text
backend/app/agents/jd_builder/tools.py - Context and drafting tools → Published JD records: saves publication
backend/app/agents/jd_builder/tools.py - Context and drafting tools → HR approval: pauses for approval
README.md - Careers endpoints → PostgreSQL sessions: reads career data
backend/app/routers/careers.py - Careers endpoints → Company knowledge model: uses company schema
backend/app/routers/careers.py - Careers endpoints → Careers page: serves listings
README.md - HR approval → Conversation graph: resumes chat