# pankaj-22/agenticai_poc architecture

> Architecture diagram of the GitHub repository pankaj-22/agenticai_poc, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pankaj-22/agenticai_poc
- Repository: https://github.com/pankaj-22/agenticai_poc

## Overview

##### Project type and purpose
- This is a CLI‐style AI proof-of-concept (PoC) tool: “Resume ATS Score Checker using CreAI framework.”
- It ingests a resume, orchestrates a set of AI agents/tasks defined in YAML, calls the Google Gemini API, and generates a scoring summary (output/summary.md).

##### File structure
- Top level
– LICENSE, README.md, pyproject.toml, requirment (dependency list)
– googleGemini/ (helper module containing an API test for Gemini)
– output/ (where the final summary.md lands)
- src/resume/
– main.py (entry point)
– crew.py (orchestrator of AI agents)
– agents.py (agent definitions)
– tasks.py (task/workflow definitions)
- No separate “frontend” – this is a single process CLI app.

##### README for additional insights
- Relies on two YAMLs (agents.yaml, tasks.yaml) to configure agent roles and workflows
- Uses a .env file for keys (not shown but implied)
- Core framework is CreAI; external dependency is Google Gemini API

##### Detail without overthinking
- Module as its own component
- Configuration (agents.yaml, tasks.yaml, .env) feeding into the orchestrator
- Final output file path as a sink

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Nodes
    User["User/CLI"] 
    Main["CLI / main.py"]:::internal
    ConfigLoader["Config Loader (YAML + .env)"]:::internal
    subgraph "Configuration Files"
        PyProj["pyproject.toml"]:::config
        Req["requirment"]:::config
        Readme["README.md"]:::config
        License["LICENSE"]:::config
    end
    Crew["Crew Orchestrator (crew.py)"]:::internal
    Agents["Agent Definitions (agents.py)"]:::internal
    Tasks["Task Workflows (tasks.py)"]:::internal
    Gemini["Google Gemini API"]:::external
    Output["Output Writer (output/summary.md)"]:::io

    %% Connections
    User -->|pass resume file path| Main
    Main -->|load config| ConfigLoader
    ConfigLoader -->|reads files| PyProj
    ConfigLoader -->|reads files| Req
    ConfigLoader -->|reads files| Readme
    ConfigLoader -->|reads files| License
    Main -->|instantiate crew| Crew
    Crew -->|dispatch tasks| Agents
    Crew -->|dispatch workflows| Tasks
    Agents -->|send prompts| Gemini
    Tasks -->|send prompts| Gemini
    Gemini -->|responses| Crew
    Crew -->|generate summary| Output

    %% Click Events
    click Main "https://github.com/pankaj-22/agenticai_poc/blob/main/src/resume/main.py"
    click Crew "https://github.com/pankaj-22/agenticai_poc/blob/main/src/resume/crew.py"
    click Agents "https://github.com/pankaj-22/agenticai_poc/blob/main/src/resume/agents.py"
    click Tasks "https://github.com/pankaj-22/agenticai_poc/blob/main/src/resume/tasks.py"
    click Gemini "https://github.com/pankaj-22/agenticai_poc/blob/main/googleGemini/apiTest.py"
    click Output "https://github.com/pankaj-22/agenticai_poc/blob/main/output/summary.md"
    click PyProj "https://github.com/pankaj-22/agenticai_poc/blob/main/pyproject.toml"
    click Req "https://github.com/pankaj-22/agenticai_poc/tree/main/requirment"
    click Readme "https://github.com/pankaj-22/agenticai_poc/blob/main/README.md"
    click License "https://github.com/pankaj-22/agenticai_poc/tree/main/LICENSE"

    %% Styles
    classDef internal fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef config fill:#90EE90,stroke:#000,stroke-width:1px
    classDef external fill:#FFA500,stroke:#000,stroke-width:1px
    classDef io fill:#D3D3D3,stroke:#000,stroke-width:1px
```
