How xiaoming0313883/404-brain-not-found-recruiter works
404Hire is a two-sided AI recruitment workspace: hiring managers define roles and source candidates, while candidates apply, complete profile information, and progress through screening. Its backend coordinates guarded agent tasks for role requirements, resume parsing, bias analysis, matching, interviews, and reports, then persists hiring state. The README documents integrations and capabilities beyond the sampled excerpts; those are included only where their paths are supported by the tree, and uncertain wiring is omitted.
Main entry points: graph.py Recruiting supervisor · main.py FastAPI application · database.py Supabase persistence · candidates.py Candidate endpoints
Components 27
User portals
- Portal router
src/app/App.tsx - Manager workspace
src/app/components/HiringManagerPortal.tsx - Candidate workspace
src/app/components/CandidatePortal.tsx - Candidate applications
src/app/components/candidate/CandidateHome.tsx - API client
src/app/api.ts
Recruitment API
- FastAPI application
backend/main.py - Job endpoints
backend/app/routes/jobs.py - Candidate endpoints
backend/app/routes/candidates.py - Agent endpoints
backend/app/routes/agents.py - Settings endpoints
backend/app/routes/settings.py
Agent workflow
- Recruiting supervisor
backend/app/services/agents/graph.py - Role requirements
backend/app/services/agents/requirement_agent.py - Resume understanding
backend/app/services/agents/resume_agent.py - Bias analysis
backend/app/services/agents/bias_agent.py - Candidate matching
backend/app/services/agents/matching_agent.py - Interview screening
backend/app/services/agents/interview_agent.py - Candidate reports
backend/app/services/agents/report_agent.py - Agent guardrails
backend/app/services/agents/guardrails.py
Data and integrations
- Supabase persistence
backend/app/database.py - LinkedIn profile sourcing
backend/app/services/linkedin_profiles.py - Email delivery
backend/app/services/mailer.py
Other components
- Hiring manager
- Candidate
- LLM service
- Supabase
- Apify
- SMTP service
Connections 30
- Hiring manager → Portal router: opens portal
- Candidate → Portal router: opens portal
- Portal router → Manager workspace: routes manager
- Portal router → Candidate workspace: routes candidate
- Candidate workspace → Candidate applications: shows applications
- Candidate applications → API client: requests jobs
- Manager workspace → API client: requests workspace data
- API client → FastAPI application: calls API
- FastAPI application → Job endpoints: registers routes
- FastAPI application → Candidate endpoints: registers routes
- FastAPI application → Agent endpoints: registers routes
- FastAPI application → Settings endpoints: registers routes
- FastAPI application → Supabase persistence: initializes
- Candidate endpoints → Recruiting supervisor: runs application tasks
- Agent endpoints → Recruiting supervisor: runs agent tasks
- Recruiting supervisor → Agent guardrails: checks inputs
- Recruiting supervisor → Role requirements: dispatches task
- Recruiting supervisor → Resume understanding: dispatches task
- Recruiting supervisor → Bias analysis: dispatches task
- Recruiting supervisor → Candidate matching: dispatches task
- Recruiting supervisor → Interview screening: dispatches task
- Recruiting supervisor → Candidate reports: dispatches task
- Recruiting supervisor → LLM service: requests reasoning
- Candidate endpoints → Supabase persistence: reads and writes
- Job endpoints → Supabase persistence: reads and writes
- Settings endpoints → Supabase persistence: reads and writes
- Candidate endpoints → LinkedIn profile sourcing: sources profiles
- LinkedIn profile sourcing → Apify: scrapes profiles
- Email delivery → SMTP service: delivers email
- Supabase persistence → Supabase: reads and writes