# aranya-chatterjee/langgraph-adk-version architecture

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

- Interactive diagram: https://gitdiagram.com/aranya-chatterjee/langgraph-adk-version
- Repository: https://github.com/aranya-chatterjee/langgraph-adk-version

## Overview

This is a LangGraph-based GitHub issue triage agent, exposed as a FastAPI service. Its main workflow fetches an issue, classifies it with Groq, verifies the label, retries uncertain classifications, and can pause for human input before finalizing. The numbered scripts demonstrate graph concepts and deployment patterns separately from the unified agent. The runtime workflow is supported by the agent source and README; demo scripts are shown as capabilities, not connected into an unsupported shared pipeline.

Main entry points: [`main.py`](https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/main.py) (FastAPI endpoints), [`agent_graph.py`](https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/agent_graph.py) (Verify label)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API service"]
  node_fastapi["FastAPI endpoints<br/>[main.py]"]
end

subgraph group_workflow["Triage workflow"]
  node_graph["Compiled triage graph<br/>[agent_graph.py]"]
  node_fetch["Fetch issue<br/>[agent_graph.py]"]
  node_classify["Classify issue<br/>[agent_graph.py]"]
  node_verify["Verify label<br/>[agent_graph.py]"]
  node_retry["Retry counter<br/>[agent_graph.py]"]
  node_escalate["Human escalation<br/>[agent_graph.py]"]
  node_finalize["Finalize label<br/>[agent_graph.py]"]
end

subgraph group_state["State and persistence"]
  node_checkpoint[("In-memory checkpoint<br/>[main.py]")]
end

subgraph group_examples["Concept examples"]
  node_fundamentals["Graph fundamentals"]
  node_reducers["State and reducers"]
  node_routing["Conditional routing"]
  node_loops["Loops and limits"]
  node_structured["Structured verification"]
  node_hitl_example["Human-in-loop demo"]
  node_deployment_example["Persistence demo"]
end

node_caller(("API caller"))
node_human(("Human reviewer"))
node_github["GitHub API"]
node_groq["Groq models"]

node_caller -->|"submits requests"| node_fastapi
node_fastapi -->|"invokes graph"| node_graph
node_human -->|"submits label"| node_fastapi
node_fastapi -->|"configures saver"| node_checkpoint
node_graph -->|"starts at"| node_fetch
node_fetch -->|"requests issue"| node_github
node_fetch -->|"routes on success"| node_classify
node_classify -->|"calls model"| node_groq
node_classify -->|"passes label"| node_verify
node_verify -->|"requests verdict"| node_groq
node_verify -->|"routes confirmed"| node_finalize
node_verify -->|"routes uncertain"| node_retry
node_retry -->|"retries under limit"| node_classify
node_retry -->|"escalates at limit"| node_escalate
node_escalate -->|"continues after resume"| node_finalize
node_finalize -.->|"returns result"| node_fastapi

click node_fastapi "https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/main.py"
click node_graph "https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/agent_graph.py"
click node_fetch "https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/agent_graph.py"
click node_classify "https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/agent_graph.py"
click node_verify "https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/agent_graph.py"
click node_retry "https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/agent_graph.py"
click node_escalate "https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/agent_graph.py"
click node_finalize "https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/agent_graph.py"
click node_checkpoint "https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/main.py"
click node_fundamentals "https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/01_graph_fundamentals.py"
click node_reducers "https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/02_state_and_reducers.py"
click node_routing "https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/03_conditional_routing.py"
click node_loops "https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/04_loops_and_termination.py"
click node_structured "https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/05_structured_verification.py"
click node_hitl_example "https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/06_human_in_the_loop.py"
click node_deployment_example "https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/07_persistence_and_deployment.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_fastapi,node_human toneBlue
class node_graph,node_fetch,node_classify,node_verify,node_retry,node_escalate,node_finalize toneAmber
class node_checkpoint,node_caller,node_github toneMint
class node_fundamentals,node_reducers,node_routing,node_loops,node_structured,node_hitl_example,node_deployment_example toneRose
class node_groq toneIndigo
```

## Components

### API service

- [FastAPI endpoints](https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/main.py): `main.py`

### Triage workflow

- [Compiled triage graph](https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/agent_graph.py): `agent_graph.py`
- [Fetch issue](https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/agent_graph.py): `agent_graph.py`
- [Classify issue](https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/agent_graph.py): `agent_graph.py`
- [Verify label](https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/agent_graph.py): `agent_graph.py`
- [Retry counter](https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/agent_graph.py): `agent_graph.py`
- [Human escalation](https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/agent_graph.py): `agent_graph.py`
- [Finalize label](https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/agent_graph.py): `agent_graph.py`

### State and persistence

- [In-memory checkpoint](https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/main.py): `main.py`

### Concept examples

- [Graph fundamentals](https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/01_graph_fundamentals.py): `01_graph_fundamentals.py`
- [State and reducers](https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/02_state_and_reducers.py): `02_state_and_reducers.py`
- [Conditional routing](https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/03_conditional_routing.py): `03_conditional_routing.py`
- [Loops and limits](https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/04_loops_and_termination.py): `04_loops_and_termination.py`
- [Structured verification](https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/05_structured_verification.py): `05_structured_verification.py`
- [Human-in-loop demo](https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/06_human_in_the_loop.py): `06_human_in_the_loop.py`
- [Persistence demo](https://github.com/aranya-chatterjee/langgraph-adk-version/blob/main/07_persistence_and_deployment.py): `07_persistence_and_deployment.py`

### Other components

- **API caller**
- **Human reviewer**
- **GitHub API**
- **Groq models**

## Connections

- API caller → FastAPI endpoints: submits requests (evidence: `README.md`)
- FastAPI endpoints → Compiled triage graph: invokes graph (evidence: `main.py`)
- Human reviewer → FastAPI endpoints: submits label (evidence: `README.md`)
- FastAPI endpoints → In-memory checkpoint: configures saver (evidence: `main.py`)
- Compiled triage graph → Fetch issue: starts at (evidence: `agent_graph.py`)
- Fetch issue → GitHub API: requests issue (evidence: `agent_graph.py`)
- Fetch issue → Classify issue: routes on success (evidence: `agent_graph.py`)
- Classify issue → Groq models: calls model (evidence: `agent_graph.py`)
- Classify issue → Verify label: passes label (evidence: `agent_graph.py`)
- Verify label → Groq models: requests verdict (evidence: `agent_graph.py`)
- Verify label → Finalize label: routes confirmed (evidence: `agent_graph.py`)
- Verify label → Retry counter: routes uncertain (evidence: `agent_graph.py`)
- Retry counter → Classify issue: retries under limit (evidence: `agent_graph.py`)
- Retry counter → Human escalation: escalates at limit (evidence: `agent_graph.py`)
- Human escalation → Finalize label: continues after resume (evidence: `agent_graph.py`)
- Finalize label → FastAPI endpoints: returns result (evidence: `main.py`)
