How saedelbarshly/agentic-ai works
AI CV & Job Analyzer accepts CV text and a job description, extracts a candidate profile, checks evidence sufficiency, analyzes job requirements, then routes to an application-ready report or gap review. The workflow also validates model-generated evidence; a failed CV gate returns needs_input before job analysis. The API maps provider failures to safe HTTP errors, and the Groq adapter supplies structured-output calls with retries. Edges reflect README statements and indexed or excerpted references; unsampled implementation details are not inferred.
Main entry points: workflow.py Analysis workflow · analysis.py Analysis endpoint · main.py FastAPI application · groq_provider.py Groq JSON provider
Components 17
API boundary
- Analysis endpoint
app/api/routes/analysis.py - Request and response models
app/schemas.py
Analysis workflow
- Analysis workflow
app/services/workflow.py - CV extraction
app/prompts.py - CV sufficiency gate
app/services/gates.py - Job analysis
app/prompts.py - Required-match gate
app/services/gates.py - Application-ready report
app/prompts.py - Gap review
app/prompts.py - Evidence validation
app/services/workflow.py
Model provider
- Groq JSON provider
app/providers/groq_provider.py - Groq API
Runtime support
- FastAPI application
app/main.py - Runtime settings
app/core/config.py - Logging setup
app/core/logging.py - Provider error types
app/core/errors.py
Other components
- API client
Connections 21
- API client → Analysis endpoint: submits analysis
README.md - Analysis endpoint → Request and response models: validates payload
app/api/routes/analysis.py - Analysis endpoint → Analysis workflow: runs workflow
app/api/routes/analysis.py - Analysis endpoint → Groq JSON provider: provides dependency
app/api/routes/analysis.py - Analysis endpoint → Runtime settings: checks limits
app/api/routes/analysis.py - Analysis workflow → CV extraction: uses prompt
app/services/workflow.py - Analysis workflow → Groq JSON provider: requests structured output
app/services/workflow.py - Analysis workflow → CV sufficiency gate: validates profile
app/services/workflow.py - Analysis workflow → Job analysis: uses prompt
app/services/workflow.py - Analysis workflow → Required-match gate: evaluates requirements
app/services/workflow.py - Analysis workflow → Application-ready report: uses prompt
app/services/workflow.py - Analysis workflow → Gap review: uses prompt
app/services/workflow.py - Analysis workflow → Evidence validation: validates evidence
app/services/workflow.py - Analysis workflow → Request and response models: uses models
app/services/workflow.py - Groq JSON provider → Runtime settings: reads credentials and limits
app/providers/groq_provider.py - Groq JSON provider → Groq API: sends completion request
app/providers/groq_provider.py - FastAPI application → Analysis endpoint: mounts router
app/main.py - FastAPI application → Runtime settings: loads settings
app/main.py - FastAPI application → Logging setup: configures logging
app/main.py - FastAPI application → Provider error types: maps failures
app/main.py - Logging setup → Runtime settings: reads log level
app/core/logging.py