# alhpeter/python_package_dependency_evaluation_tool architecture

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

- Interactive diagram: https://gitdiagram.com/alhpeter/python_package_dependency_evaluation_tool
- Repository: https://github.com/alhpeter/python_package_dependency_evaluation_tool

## Overview

This is a bounded Python dependency-evaluation tool for human investigation, not a vulnerability scanner. A user runs configured requirements manifests; the runner invokes the pipeline, which gathers package metadata, builds a dependency graph, computes metrics, ranks packages into evidence-backed cards, and writes per-experiment artifacts. A separate local dashboard reads those artifacts and supports exploration plus optional Groq explanations. The main orchestration and metadata calls are evidenced by excerpts; dashboard behavior and several analysis stages are also documented in the README, while unsampled implementation details are not inferred.

Main entry points: [`idrf/pipeline.py`](https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/pipeline.py) (Pipeline orchestrator), [`idrf/data_processing.py`](https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/data_processing.py) (Metadata discovery), [`dashboard_server.py`](https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/dashboard_server.py) (Dashboard API), [`idrf/reasoning_engine.py`](https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/reasoning_engine.py) (Priority and cards)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_execution["Evaluation workflow"]
  node_runner["Experiment runner<br/>[run_idrf.py]"]
  node_pipeline["Pipeline orchestrator<br/>[pipeline.py]"]
  node_manifest["Requirements manifest"]
end

subgraph group_analysis["Analysis and reasoning"]
  node_metadata["Metadata discovery<br/>[data_processing.py]"]
  node_models["Domain records<br/>[models.py]"]
  node_graph["Dependency graph<br/>[graph_analysis.py]"]
  node_metrics["Graph metrics<br/>[graph_analysis.py]"]
  node_reasoning["Priority and cards"]
  node_config["Analysis thresholds<br/>[config.py]"]
end

subgraph group_results["Results and dashboard"]
  node_visualization["Graph image<br/>[visualization.py]"]
  node_artifacts[("Experiment artifacts<br/>[evaluation.py]")]
  node_terminal["Terminal reporting<br/>[reporting.py]"]
  node_dashboard_server["Dashboard API"]
  node_dashboard_ui["Dashboard interface<br/>[app.js]"]
end

node_analyst(("Analyst"))
node_pypi{{"PyPI API"}}
node_github{{"GitHub API"}}
node_groq{{"Groq service"}}

node_analyst -->|"runs experiments"| node_runner
node_runner -->|"invokes pipeline"| node_pipeline
node_runner -->|"reports progress"| node_terminal
node_pipeline -->|"evaluates"| node_manifest
node_pipeline -->|"loads package nodes"| node_metadata
node_metadata -->|"fetches metadata"| node_pypi
node_metadata -->|"fetches repository data"| node_github
node_metadata -->|"creates records"| node_models
node_pipeline -->|"builds graph"| node_graph
node_graph -->|"extracts dependencies"| node_metadata
node_graph -->|"uses package records"| node_models
node_pipeline -->|"computes metrics"| node_metrics
node_pipeline -->|"generates cards"| node_reasoning
node_reasoning -->|"uses thresholds"| node_config
node_reasoning -->|"creates insight cards"| node_models
node_pipeline -->|"saves graph image"| node_visualization
node_pipeline -->|"writes results"| node_artifacts
node_pipeline -.->|"summarizes results"| node_terminal
node_analyst -->|"explores results"| node_dashboard_ui
node_dashboard_ui -.->|"requests data"| node_dashboard_server
node_dashboard_server -->|"reads saved files"| node_artifacts
node_dashboard_server -->|"explains results"| node_reasoning
node_dashboard_server -->|"requests explanations"| node_groq

click node_runner "https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/run_idrf.py"
click node_pipeline "https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/pipeline.py"
click node_manifest "https://github.com/alhpeter/python_package_dependency_evaluation_tool/tree/main/data"
click node_metadata "https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/data_processing.py"
click node_models "https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/models.py"
click node_graph "https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/graph_analysis.py"
click node_metrics "https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/graph_analysis.py"
click node_reasoning "https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/reasoning_engine.py"
click node_config "https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/config.py"
click node_visualization "https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/visualization.py"
click node_artifacts "https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/evaluation.py"
click node_terminal "https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/reporting.py"
click node_dashboard_server "https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/dashboard_server.py"
click node_dashboard_ui "https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/dashboard/app.js"

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_runner,node_pipeline,node_manifest toneBlue
class node_metadata,node_models,node_graph,node_metrics,node_reasoning,node_config toneAmber
class node_visualization,node_artifacts,node_terminal,node_dashboard_server,node_dashboard_ui,node_pypi,node_github toneMint
class node_analyst,node_groq toneIndigo
```

## Components

### Evaluation workflow

- [Experiment runner](https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/run_idrf.py): `run_idrf.py`
- [Pipeline orchestrator](https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/pipeline.py): `idrf/pipeline.py`
- [Requirements manifest](https://github.com/alhpeter/python_package_dependency_evaluation_tool/tree/main/data): `data`

### Analysis and reasoning

- [Metadata discovery](https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/data_processing.py): `idrf/data_processing.py`
- [Domain records](https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/models.py): `idrf/models.py`
- [Dependency graph](https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/graph_analysis.py): `idrf/graph_analysis.py`
- [Graph metrics](https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/graph_analysis.py): `idrf/graph_analysis.py`
- [Priority and cards](https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/reasoning_engine.py): `idrf/reasoning_engine.py`
- [Analysis thresholds](https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/config.py): `idrf/config.py`

### Results and dashboard

- [Graph image](https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/visualization.py): `idrf/visualization.py`
- [Experiment artifacts](https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/evaluation.py): `idrf/evaluation.py`
- [Terminal reporting](https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/idrf/reporting.py): `idrf/reporting.py`
- [Dashboard API](https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/dashboard_server.py): `dashboard_server.py`
- [Dashboard interface](https://github.com/alhpeter/python_package_dependency_evaluation_tool/blob/main/dashboard/app.js): `dashboard/app.js`

### Other components

- **Analyst**
- **PyPI API**
- **GitHub API**
- **Groq service**

## Connections

- Analyst → Experiment runner: runs experiments (evidence: `README.md`)
- Experiment runner → Pipeline orchestrator: invokes pipeline (evidence: `run_idrf.py`)
- Experiment runner → Terminal reporting: reports progress (evidence: `run_idrf.py`)
- Pipeline orchestrator → Requirements manifest: evaluates (evidence: `README.md`)
- Pipeline orchestrator → Metadata discovery: loads package nodes (evidence: `idrf/pipeline.py`)
- Metadata discovery → PyPI API: fetches metadata (evidence: `idrf/data_processing.py`)
- Metadata discovery → GitHub API: fetches repository data (evidence: `idrf/data_processing.py`)
- Metadata discovery → Domain records: creates records (evidence: `idrf/data_processing.py`)
- Pipeline orchestrator → Dependency graph: builds graph (evidence: `idrf/pipeline.py`)
- Dependency graph → Metadata discovery: extracts dependencies (evidence: `idrf/graph_analysis.py`)
- Dependency graph → Domain records: uses package records (evidence: `idrf/graph_analysis.py`)
- Pipeline orchestrator → Graph metrics: computes metrics (evidence: `idrf/pipeline.py`)
- Pipeline orchestrator → Priority and cards: generates cards (evidence: `idrf/pipeline.py`)
- Priority and cards → Analysis thresholds: uses thresholds (evidence: `idrf/reasoning_engine.py`)
- Priority and cards → Domain records: creates insight cards (evidence: `idrf/reasoning_engine.py`)
- Pipeline orchestrator → Graph image: saves graph image (evidence: `idrf/pipeline.py`)
- Pipeline orchestrator → Experiment artifacts: writes results (evidence: `idrf/pipeline.py`)
- Pipeline orchestrator → Terminal reporting: summarizes results
- Analyst → Dashboard interface: explores results (evidence: `README.md`)
- Dashboard interface → Dashboard API: requests data (evidence: `README.md`)
- Dashboard API → Experiment artifacts: reads saved files (evidence: `README.md`)
- Dashboard API → Priority and cards: explains results (evidence: `dashboard_server.py`)
- Dashboard API → Groq service: requests explanations (evidence: `dashboard_server.py`)
