# avani-maurya/agentic-honeypot architecture

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

- Interactive diagram: https://gitdiagram.com/avani-maurya/agentic-honeypot
- Repository: https://github.com/avani-maurya/agentic-honeypot

## Overview

The checked-in product is a small FastAPI message-processing service: an authenticated client submits a message, the route evaluates it and returns a scam assessment, extracted indicators, engagement metrics, and a reply. The README describes a broader socket-based honeypot with attacker logging, but those components are not present in the supplied tree; the graph therefore shows only the implemented API. All implementation evidence comes from main.py.

Main entry points: [`main.py`](https://github.com/avani-maurya/agentic-honeypot/blob/main/main.py) (Message Route)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API"]
  node_message_route["Message Route<br/>[main.py]"]
  node_api_key_check["API Key Check<br/>[main.py]"]
end

subgraph group_analysis["Message Analysis"]
  node_scam_detection["Scam Detection<br/>[main.py]"]
  node_intelligence_extraction["Intelligence Extraction<br/>[main.py]"]
  node_engagement_metrics["Engagement Metrics<br/>[main.py]"]
  node_agent_reply["Agent Reply<br/>[main.py]"]
end

subgraph group_response["Response"]
  node_api_response["API Response<br/>[main.py]"]
end

node_client(("API Client"))

node_client -->|"submits message"| node_message_route
node_message_route -->|"requires authentication"| node_api_key_check
node_message_route -->|"detects scam"| node_scam_detection
node_message_route -->|"extracts indicators"| node_intelligence_extraction
node_message_route -->|"calculates metrics"| node_engagement_metrics
node_message_route -->|"selects reply"| node_agent_reply
node_message_route -->|"assembles result"| node_api_response
node_api_response -->|"returns result"| node_client

click node_message_route "https://github.com/avani-maurya/agentic-honeypot/blob/main/main.py"
click node_api_key_check "https://github.com/avani-maurya/agentic-honeypot/blob/main/main.py"
click node_scam_detection "https://github.com/avani-maurya/agentic-honeypot/blob/main/main.py"
click node_intelligence_extraction "https://github.com/avani-maurya/agentic-honeypot/blob/main/main.py"
click node_engagement_metrics "https://github.com/avani-maurya/agentic-honeypot/blob/main/main.py"
click node_agent_reply "https://github.com/avani-maurya/agentic-honeypot/blob/main/main.py"
click node_api_response "https://github.com/avani-maurya/agentic-honeypot/blob/main/main.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_message_route,node_api_key_check,node_client toneBlue
class node_scam_detection,node_intelligence_extraction,node_engagement_metrics,node_agent_reply toneAmber
class node_api_response toneMint
```

## Components

### API

- [Message Route](https://github.com/avani-maurya/agentic-honeypot/blob/main/main.py): `main.py`
- [API Key Check](https://github.com/avani-maurya/agentic-honeypot/blob/main/main.py): `main.py`

### Message Analysis

- [Scam Detection](https://github.com/avani-maurya/agentic-honeypot/blob/main/main.py): `main.py`
- [Intelligence Extraction](https://github.com/avani-maurya/agentic-honeypot/blob/main/main.py): `main.py`
- [Engagement Metrics](https://github.com/avani-maurya/agentic-honeypot/blob/main/main.py): `main.py`
- [Agent Reply](https://github.com/avani-maurya/agentic-honeypot/blob/main/main.py): `main.py`

### Response

- [API Response](https://github.com/avani-maurya/agentic-honeypot/blob/main/main.py): `main.py`

### Other components

- **API Client**

## Connections

- API Client → Message Route: submits message (evidence: `main.py`)
- Message Route → API Key Check: requires authentication (evidence: `main.py`)
- Message Route → Scam Detection: detects scam (evidence: `main.py`)
- Message Route → Intelligence Extraction: extracts indicators (evidence: `main.py`)
- Message Route → Engagement Metrics: calculates metrics (evidence: `main.py`)
- Message Route → Agent Reply: selects reply (evidence: `main.py`)
- Message Route → API Response: assembles result (evidence: `main.py`)
- API Response → API Client: returns result (evidence: `main.py`)
