# boubacar593/rag_agentrecruteur architecture

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

- Interactive diagram: https://gitdiagram.com/boubacar593/rag_agentrecruteur
- Repository: https://github.com/boubacar593/rag_agentrecruteur

## Overview

Recruteur Augmente AI is a local RAG assistant for recruiters: upload or edit a job description, index PDF CVs, then ask questions to compare retrieved candidate profiles against the role. The graph separates UI orchestration, document preparation, retrieval, and local model inference. README capabilities are represented, but the index and sampled code do not show a separate ranking engine or privacy enforcement beyond the stated local Ollama design.

Main entry points: [`src/app.py`](https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/app.py) (Recruitment UI), [`database/chroma_db`](https://github.com/boubacar593/rag_agentrecruteur/tree/main/database/chroma_db) (Chroma vector store), [`src/config.py`](https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/config.py) (Runtime configuration), [`src/rag.py`](https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/rag.py) (RAG chain)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Recruiter interface"]
  node_ui["Recruitment UI<br/>[app.py]"]
end

subgraph group_documents["Document preparation"]
  node_job_upload["Job upload extraction<br/>[utils.py]"]
  node_cv_loader["CV PDF loading<br/>[ingestion.py]"]
  node_chunker["Text chunking<br/>[ingestion.py]"]
end

subgraph group_rag["RAG analysis"]
  node_rag_chain["RAG chain<br/>[rag.py]"]
  node_retrieval["Candidate retrieval<br/>[rag.py]"]
  node_comparison_prompt["Role-profile comparison<br/>[rag.py]"]
end

subgraph group_local_stack["Local AI and storage"]
  node_config["Runtime configuration<br/>[config.py]"]
  node_embedding["Embedding model<br/>[database.py]"]
  node_vector_store[("Chroma vector store")]
  node_chat_model["Local chat model<br/>[rag.py]"]
end

node_recruiter(("Recruiter"))

node_recruiter -->|"uses"| node_ui
node_ui -->|"extracts job text"| node_job_upload
node_recruiter -->|"requests CV indexing"| node_ui
node_ui -->|"loads CVs"| node_cv_loader
node_cv_loader -->|"splits documents"| node_chunker
node_ui -->|"stores chunks"| node_vector_store
node_ui -->|"creates and invokes"| node_rag_chain
node_rag_chain -->|"searches profiles"| node_retrieval
node_retrieval -->|"similarity search"| node_vector_store
node_rag_chain -->|"builds prompt"| node_comparison_prompt
node_comparison_prompt -->|"invokes"| node_chat_model
node_ui -->|"configures store"| node_embedding
node_embedding -->|"embeds documents"| node_vector_store
node_config -->|"sets persistence path"| node_vector_store
node_config -->|"sets model"| node_embedding
node_config -->|"sets model"| node_chat_model
node_ui -->|"shows answer"| node_recruiter

click node_ui "https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/app.py"
click node_job_upload "https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/utils.py"
click node_cv_loader "https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/ingestion.py"
click node_chunker "https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/ingestion.py"
click node_rag_chain "https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/rag.py"
click node_retrieval "https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/rag.py"
click node_comparison_prompt "https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/rag.py"
click node_config "https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/config.py"
click node_embedding "https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/database.py"
click node_vector_store "https://github.com/boubacar593/rag_agentrecruteur/tree/main/database/chroma_db"
click node_chat_model "https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/rag.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_ui toneBlue
class node_job_upload,node_cv_loader,node_chunker toneAmber
class node_rag_chain,node_retrieval,node_comparison_prompt toneMint
class node_config,node_embedding,node_vector_store,node_chat_model toneRose
class node_recruiter toneIndigo
```

## Components

### Recruiter interface

- [Recruitment UI](https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/app.py): `src/app.py`

### Document preparation

- [Job upload extraction](https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/utils.py): `src/utils.py`
- [CV PDF loading](https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/ingestion.py): `src/ingestion.py`
- [Text chunking](https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/ingestion.py): `src/ingestion.py`

### RAG analysis

- [RAG chain](https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/rag.py): `src/rag.py`
- [Candidate retrieval](https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/rag.py): `src/rag.py`
- [Role-profile comparison](https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/rag.py): `src/rag.py`

### Local AI and storage

- [Runtime configuration](https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/config.py): `src/config.py`
- [Embedding model](https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/database.py): `src/database.py`
- [Chroma vector store](https://github.com/boubacar593/rag_agentrecruteur/tree/main/database/chroma_db): `database/chroma_db`
- [Local chat model](https://github.com/boubacar593/rag_agentrecruteur/blob/main/src/rag.py): `src/rag.py`

### Other components

- **Recruiter**

## Connections

- Recruiter → Recruitment UI: uses (evidence: `README.md`)
- Recruitment UI → Job upload extraction: extracts job text (evidence: `src/app.py`)
- Recruiter → Recruitment UI: requests CV indexing (evidence: `src/app.py`)
- Recruitment UI → CV PDF loading: loads CVs (evidence: `src/app.py`)
- CV PDF loading → Text chunking: splits documents (evidence: `src/ingestion.py`)
- Recruitment UI → Chroma vector store: stores chunks (evidence: `src/app.py`)
- Recruitment UI → RAG chain: creates and invokes (evidence: `src/app.py`)
- RAG chain → Candidate retrieval: searches profiles (evidence: `src/rag.py`)
- Candidate retrieval → Chroma vector store: similarity search (evidence: `src/rag.py`)
- RAG chain → Role-profile comparison: builds prompt (evidence: `src/rag.py`)
- Role-profile comparison → Local chat model: invokes (evidence: `src/rag.py`)
- Recruitment UI → Embedding model: configures store (evidence: `src/database.py`)
- Embedding model → Chroma vector store: embeds documents (evidence: `src/database.py`)
- Runtime configuration → Chroma vector store: sets persistence path
- Runtime configuration → Embedding model: sets model (evidence: `src/database.py`)
- Runtime configuration → Local chat model: sets model (evidence: `src/rag.py`)
- Recruitment UI → Recruiter: shows answer (evidence: `src/app.py`)
