# cosmicviraj/c-honeypot architecture

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

- Interactive diagram: https://gitdiagram.com/cosmicviraj/c-honeypot
- Repository: https://github.com/cosmicviraj/c-honeypot

## Overview

C-Honeypot is a lightweight decoy server intended to detect unauthorized access, log suspicious activity, and simulate configurable responses. The documented workflow is a client connecting to the server, exchanging a message, and receiving a response. The client’s socket behavior is shown in source; server-side behavior is documented in the README but its C implementation was not excerpted, so internal server stages are not inferred.

Main entry points: [`client.py`](https://github.com/cosmicviraj/c-honeypot/blob/main/client.py) (Python client), [`.SOURCE /HONEYPOT.c`](https://github.com/cosmicviraj/c-honeypot/blob/main/.SOURCE%20/HONEYPOT.c) (Honeypot server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client"]
  node_client_script["Python client<br/>[client.py]"]
end

subgraph group_honeypot["Honeypot"]
  node_server["Honeypot server<br/>[HONEYPOT.c]"]
end

node_user(("User"))

node_user -->|"runs"| node_client_script
node_client_script -->|"connects and exchanges data"| node_server

click node_client_script "https://github.com/cosmicviraj/c-honeypot/blob/main/client.py"
click node_server "https://github.com/cosmicviraj/c-honeypot/blob/main/.SOURCE%20/HONEYPOT.c"

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_client_script,node_user toneBlue
class node_server toneAmber
```

## Components

### Client

- [Python client](https://github.com/cosmicviraj/c-honeypot/blob/main/client.py): `client.py`

### Honeypot

- [Honeypot server](https://github.com/cosmicviraj/c-honeypot/blob/main/.SOURCE%20/HONEYPOT.c): `.SOURCE /HONEYPOT.c`

### Other components

- **User**

## Connections

- User → Python client: runs (evidence: `README.md`)
- Python client → Honeypot server: connects and exchanges data (evidence: `client.py`)