# shreyaasdeworld/ai_hiring_intelligence_platform architecture

> Architecture diagram of the GitHub repository shreyaasdeworld/ai_hiring_intelligence_platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shreyaasdeworld/ai_hiring_intelligence_platform
- Repository: https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform

## Overview

This is a Streamlit resume-screening application. A recruiter enters job requirements and uploads a resume; the app validates inputs, extracts text, estimates token usage, chunks the resume, and stores its embeddings in ChromaDB. It then sends the resume and requirements through a LangChain prompt/model/parser chain, displays the screening report, and offers a download. The README also describes semantic retrieval as a capability, but the shown app stores embeddings without performing retrieval. All internal components are implemented in app.py; external API links are not directly shown.

Main entry points: [`app.py`](https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py) (Input validation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Recruiter workflow"]
  node_streamlit_ui["Streamlit UI<br/>[app.py]"]
  node_input_validation["Input validation<br/>[app.py]"]
  node_report_display["Report display<br/>[app.py]"]
  node_report_download["Report download<br/>[app.py]"]
end

subgraph group_resume["Resume processing"]
  node_resume_extraction["Resume extraction<br/>[app.py]"]
  node_pdf_reader["PDF reader<br/>[app.py]"]
  node_docx_reader["DOCX reader<br/>[app.py]"]
  node_txt_reader["TXT reader<br/>[app.py]"]
  node_token_counting["Token counting<br/>[app.py]"]
  node_text_chunking["Text chunking<br/>[app.py]"]
  node_embedding_client["Embedding client<br/>[app.py]"]
  node_chroma_store[("ChromaDB store<br/>[app.py]")]
end

subgraph group_screening["AI screening"]
  node_prompt_template["Screening prompt<br/>[app.py]"]
  node_langchain_chain["LangChain chain<br/>[app.py]"]
  node_chat_model["Chat model<br/>[app.py]"]
  node_output_parser["Output parser<br/>[app.py]"]
end

node_recruiter(("Recruiter"))
node_openai_api{{"OpenAI API"}}

node_recruiter -->|"enters inputs"| node_streamlit_ui
node_streamlit_ui -->|"validates inputs"| node_input_validation
node_input_validation -->|"extracts resume"| node_resume_extraction
node_resume_extraction -->|"reads PDF"| node_pdf_reader
node_resume_extraction -->|"reads DOCX"| node_docx_reader
node_resume_extraction -->|"reads TXT"| node_txt_reader
node_input_validation -->|"counts tokens"| node_token_counting
node_input_validation -->|"splits text"| node_text_chunking
node_input_validation -->|"stores chunks"| node_chroma_store
node_chroma_store -->|"embeds chunks"| node_embedding_client
node_input_validation -->|"invokes screening"| node_langchain_chain
node_langchain_chain -->|"formats prompt"| node_prompt_template
node_langchain_chain -->|"calls model"| node_chat_model
node_langchain_chain -->|"parses output"| node_output_parser
node_input_validation -->|"shows report"| node_report_display
node_report_display -->|"offers download"| node_report_download
node_embedding_client -.->|"requests embeddings"| node_openai_api
node_chat_model -.->|"requests completion"| node_openai_api

click node_streamlit_ui "https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py"
click node_input_validation "https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py"
click node_report_display "https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py"
click node_report_download "https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py"
click node_resume_extraction "https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py"
click node_pdf_reader "https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py"
click node_docx_reader "https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py"
click node_txt_reader "https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py"
click node_token_counting "https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py"
click node_text_chunking "https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py"
click node_embedding_client "https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py"
click node_chroma_store "https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py"
click node_prompt_template "https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py"
click node_langchain_chain "https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py"
click node_chat_model "https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py"
click node_output_parser "https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_streamlit_ui,node_input_validation,node_report_display,node_report_download toneBlue
class node_resume_extraction,node_pdf_reader,node_docx_reader,node_txt_reader,node_token_counting,node_text_chunking,node_embedding_client,node_chroma_store toneAmber
class node_prompt_template,node_langchain_chain,node_chat_model,node_output_parser,node_openai_api toneMint
class node_recruiter toneIndigo
```

## Components

### Recruiter workflow

- [Streamlit UI](https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py): `app.py`
- [Input validation](https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py): `app.py`
- [Report display](https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py): `app.py`
- [Report download](https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py): `app.py`

### Resume processing

- [Resume extraction](https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py): `app.py`
- [PDF reader](https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py): `app.py`
- [DOCX reader](https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py): `app.py`
- [TXT reader](https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py): `app.py`
- [Token counting](https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py): `app.py`
- [Text chunking](https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py): `app.py`
- [Embedding client](https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py): `app.py`
- [ChromaDB store](https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py): `app.py`

### AI screening

- [Screening prompt](https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py): `app.py`
- [LangChain chain](https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py): `app.py`
- [Chat model](https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py): `app.py`
- [Output parser](https://github.com/shreyaasdeworld/ai_hiring_intelligence_platform/blob/main/app.py): `app.py`

### Other components

- **Recruiter**
- **OpenAI API**

## Connections

- Recruiter → Streamlit UI: enters inputs (evidence: `app.py`)
- Streamlit UI → Input validation: validates inputs (evidence: `app.py`)
- Input validation → Resume extraction: extracts resume (evidence: `app.py`)
- Resume extraction → PDF reader: reads PDF (evidence: `app.py`)
- Resume extraction → DOCX reader: reads DOCX (evidence: `app.py`)
- Resume extraction → TXT reader: reads TXT (evidence: `app.py`)
- Input validation → Token counting: counts tokens (evidence: `app.py`)
- Input validation → Text chunking: splits text (evidence: `app.py`)
- Input validation → ChromaDB store: stores chunks (evidence: `app.py`)
- ChromaDB store → Embedding client: embeds chunks (evidence: `app.py`)
- Input validation → LangChain chain: invokes screening (evidence: `app.py`)
- LangChain chain → Screening prompt: formats prompt (evidence: `app.py`)
- LangChain chain → Chat model: calls model (evidence: `app.py`)
- LangChain chain → Output parser: parses output (evidence: `app.py`)
- Input validation → Report display: shows report (evidence: `app.py`)
- Report display → Report download: offers download (evidence: `app.py`)
- Embedding client → OpenAI API: requests embeddings
- Chat model → OpenAI API: requests completion
