# yashab-cyber/hackgpt architecture

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

- Interactive diagram: https://gitdiagram.com/yashab-cyber/hackgpt
- Repository: https://github.com/yashab-cyber/hackgpt

## Overview

HackGPT Enterprise is an AI-assisted penetration-testing and SOC platform. An authorized security user enters an assessment through the application entry point; authentication and authorization guard the request, the assessment engine records the session, AI analyzes findings, exploitation verifies payloads, and reporting returns technical and executive results. SOC analysis is a parallel log-correlation workflow. The graph also preserves documented persistence, caching, distributed workers, SIEM integrations, monitoring, and cloud orchestration. Several service links are based on README architecture because their callers were not sampled.

Main entry points: [`advance_hackgpt.py`](https://github.com/yashab-cyber/hackgpt/blob/main/advance_hackgpt.py) (Application Entry), [`ai_engine/advanced_engine.py`](https://github.com/yashab-cyber/hackgpt/blob/main/ai_engine/advanced_engine.py) (AI Analysis), [`database/manager.py`](https://github.com/yashab-cyber/hackgpt/blob/main/database/manager.py) (PostgreSQL Store), [`security/authentication.py`](https://github.com/yashab-cyber/hackgpt/blob/main/security/authentication.py) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access Runtime"]
  node_app_entry["Application Entry<br/>[advance_hackgpt.py]"]
  node_auth["Authentication<br/>[authentication.py]"]
end

subgraph group_assessment["Assessment Intelligence"]
  node_assessment_engine["Assessment Engine<br/>[advance_hackgpt.py]"]
  node_ai_engine["AI Analysis<br/>[advanced_engine.py]"]
  node_model_registry["Model Registry<br/>[model_registry.py]"]
  node_provider_adapters["Provider Adapters<br/>[providers.py]"]
  node_exploitation["Safe Exploitation<br/>[advanced_engine.py]"]
  node_reporting["Report Generator<br/>[dynamic_reports.py]"]
  node_dashboard["Live Dashboard"]
end

subgraph group_soc["SOC Operations"]
  node_soc_analysis["SOC Analysis<br/>[soc_analysis.py]"]
  node_siem_connectors["SIEM Connectors<br/>[soc_analysis.py]"]
end

subgraph group_state["State and Scale"]
  node_postgres[("PostgreSQL Store<br/>[manager.py]")]
  node_cache[("Redis Cache<br/>[cache_manager.py]")]
  node_parallel_processor["Parallel Processor"]
  node_task_workers["Celery Workers"]
end

subgraph group_cloud["Cloud Platform"]
  node_service_registry["Service Registry"]
  node_docker_manager["Docker Manager<br/>[docker_manager.py]"]
  node_kubernetes_manager["Kubernetes Manager"]
end

node_security_user(("Security User"))
node_ai_providers["AI Providers"]
node_siem_services["SIEM Services"]
node_redis_queue["Redis Queue"]
node_container_platform["Container Platform"]
node_consul["Consul Registry"]
node_prometheus[("Prometheus Metrics")]
node_grafana["Grafana Analytics"]

node_security_user -->|"starts assessment"| node_app_entry
node_app_entry -->|"authenticates request"| node_auth
node_auth -->|"checks users"| node_postgres
node_auth -.->|"audits activity"| node_siem_connectors
node_app_entry -->|"dispatches assessment"| node_assessment_engine
node_assessment_engine -->|"stores findings"| node_postgres
node_assessment_engine -->|"analyzes findings"| node_ai_engine
node_assessment_engine -->|"verifies findings"| node_exploitation
node_assessment_engine -->|"requests reports"| node_reporting
node_ai_engine -->|"selects model"| node_model_registry
node_model_registry -->|"routes provider"| node_provider_adapters
node_provider_adapters -->|"generates analysis"| node_ai_providers
node_ai_engine -->|"saves context"| node_postgres
node_ai_engine -->|"caches analysis"| node_cache
node_exploitation -->|"parallelizes tests"| node_parallel_processor
node_parallel_processor -->|"dispatches tasks"| node_task_workers
node_task_workers -->|"queues work"| node_redis_queue
node_reporting -->|"reads results"| node_postgres
node_reporting -->|"publishes updates"| node_dashboard
node_dashboard -->|"exposes metrics"| node_prometheus
node_prometheus -->|"feeds analytics"| node_grafana
node_app_entry -->|"dispatches SOC analysis"| node_soc_analysis
node_soc_analysis -->|"queries SIEM"| node_siem_connectors
node_siem_connectors -->|"collects events"| node_siem_services
node_service_registry -.->|"registers services"| node_consul
node_docker_manager -->|"manages containers"| node_container_platform
node_kubernetes_manager -->|"orchestrates workloads"| node_container_platform
node_service_registry -.->|"discovers services"| node_docker_manager
node_app_entry -->|"returns results"| node_security_user

click node_app_entry "https://github.com/yashab-cyber/hackgpt/blob/main/advance_hackgpt.py"
click node_auth "https://github.com/yashab-cyber/hackgpt/blob/main/security/authentication.py"
click node_assessment_engine "https://github.com/yashab-cyber/hackgpt/blob/main/advance_hackgpt.py"
click node_ai_engine "https://github.com/yashab-cyber/hackgpt/blob/main/ai_engine/advanced_engine.py"
click node_model_registry "https://github.com/yashab-cyber/hackgpt/blob/main/ai_engine/model_registry.py"
click node_provider_adapters "https://github.com/yashab-cyber/hackgpt/blob/main/ai_engine/providers.py"
click node_exploitation "https://github.com/yashab-cyber/hackgpt/blob/main/exploitation/advanced_engine.py"
click node_reporting "https://github.com/yashab-cyber/hackgpt/blob/main/reporting/dynamic_reports.py"
click node_dashboard "https://github.com/yashab-cyber/hackgpt/blob/main/reporting/realtime_dashboard.py"
click node_soc_analysis "https://github.com/yashab-cyber/hackgpt/blob/main/security/soc_analysis.py"
click node_siem_connectors "https://github.com/yashab-cyber/hackgpt/blob/main/security/soc_analysis.py"
click node_postgres "https://github.com/yashab-cyber/hackgpt/blob/main/database/manager.py"
click node_cache "https://github.com/yashab-cyber/hackgpt/blob/main/performance/cache_manager.py"
click node_parallel_processor "https://github.com/yashab-cyber/hackgpt/blob/main/performance/parallel_processor.py"
click node_task_workers "https://github.com/yashab-cyber/hackgpt/blob/main/performance/parallel_processor.py"
click node_service_registry "https://github.com/yashab-cyber/hackgpt/blob/main/cloud/service_registry.py"
click node_docker_manager "https://github.com/yashab-cyber/hackgpt/blob/main/cloud/docker_manager.py"
click node_kubernetes_manager "https://github.com/yashab-cyber/hackgpt/blob/main/cloud/kubernetes_manager.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_app_entry,node_auth,node_security_user toneBlue
class node_assessment_engine,node_ai_engine,node_model_registry,node_provider_adapters,node_exploitation,node_reporting,node_dashboard,node_redis_queue,node_prometheus toneAmber
class node_soc_analysis,node_siem_connectors toneMint
class node_postgres,node_cache,node_parallel_processor,node_task_workers toneRose
class node_service_registry,node_docker_manager,node_kubernetes_manager,node_ai_providers,node_siem_services,node_container_platform,node_consul,node_grafana toneIndigo
```

## Components

### Access Runtime

- [Application Entry](https://github.com/yashab-cyber/hackgpt/blob/main/advance_hackgpt.py): `advance_hackgpt.py`
- [Authentication](https://github.com/yashab-cyber/hackgpt/blob/main/security/authentication.py): `security/authentication.py`

### Assessment Intelligence

- [Assessment Engine](https://github.com/yashab-cyber/hackgpt/blob/main/advance_hackgpt.py): `advance_hackgpt.py`
- [AI Analysis](https://github.com/yashab-cyber/hackgpt/blob/main/ai_engine/advanced_engine.py): `ai_engine/advanced_engine.py`
- [Model Registry](https://github.com/yashab-cyber/hackgpt/blob/main/ai_engine/model_registry.py): `ai_engine/model_registry.py`
- [Provider Adapters](https://github.com/yashab-cyber/hackgpt/blob/main/ai_engine/providers.py): `ai_engine/providers.py`
- [Safe Exploitation](https://github.com/yashab-cyber/hackgpt/blob/main/exploitation/advanced_engine.py): `exploitation/advanced_engine.py`
- [Report Generator](https://github.com/yashab-cyber/hackgpt/blob/main/reporting/dynamic_reports.py): `reporting/dynamic_reports.py`
- [Live Dashboard](https://github.com/yashab-cyber/hackgpt/blob/main/reporting/realtime_dashboard.py): `reporting/realtime_dashboard.py`

### SOC Operations

- [SOC Analysis](https://github.com/yashab-cyber/hackgpt/blob/main/security/soc_analysis.py): `security/soc_analysis.py`
- [SIEM Connectors](https://github.com/yashab-cyber/hackgpt/blob/main/security/soc_analysis.py): `security/soc_analysis.py`

### State and Scale

- [PostgreSQL Store](https://github.com/yashab-cyber/hackgpt/blob/main/database/manager.py): `database/manager.py`
- [Redis Cache](https://github.com/yashab-cyber/hackgpt/blob/main/performance/cache_manager.py): `performance/cache_manager.py`
- [Parallel Processor](https://github.com/yashab-cyber/hackgpt/blob/main/performance/parallel_processor.py): `performance/parallel_processor.py`
- [Celery Workers](https://github.com/yashab-cyber/hackgpt/blob/main/performance/parallel_processor.py): `performance/parallel_processor.py`

### Cloud Platform

- [Service Registry](https://github.com/yashab-cyber/hackgpt/blob/main/cloud/service_registry.py): `cloud/service_registry.py`
- [Docker Manager](https://github.com/yashab-cyber/hackgpt/blob/main/cloud/docker_manager.py): `cloud/docker_manager.py`
- [Kubernetes Manager](https://github.com/yashab-cyber/hackgpt/blob/main/cloud/kubernetes_manager.py): `cloud/kubernetes_manager.py`

### Other components

- **Security User**
- **AI Providers**
- **SIEM Services**
- **Redis Queue**
- **Container Platform**
- **Consul Registry**
- **Prometheus Metrics**
- **Grafana Analytics**

## Connections

- Security User → Application Entry: starts assessment
- Application Entry → Authentication: authenticates request
- Authentication → PostgreSQL Store: checks users
- Authentication → SIEM Connectors: audits activity
- Application Entry → Assessment Engine: dispatches assessment
- Assessment Engine → PostgreSQL Store: stores findings
- Assessment Engine → AI Analysis: analyzes findings
- Assessment Engine → Safe Exploitation: verifies findings
- Assessment Engine → Report Generator: requests reports
- AI Analysis → Model Registry: selects model
- Model Registry → Provider Adapters: routes provider
- Provider Adapters → AI Providers: generates analysis
- AI Analysis → PostgreSQL Store: saves context
- AI Analysis → Redis Cache: caches analysis
- Safe Exploitation → Parallel Processor: parallelizes tests
- Parallel Processor → Celery Workers: dispatches tasks
- Celery Workers → Redis Queue: queues work
- Report Generator → PostgreSQL Store: reads results
- Report Generator → Live Dashboard: publishes updates
- Live Dashboard → Prometheus Metrics: exposes metrics
- Prometheus Metrics → Grafana Analytics: feeds analytics
- Application Entry → SOC Analysis: dispatches SOC analysis
- SOC Analysis → SIEM Connectors: queries SIEM
- SIEM Connectors → SIEM Services: collects events
- Service Registry → Consul Registry: registers services
- Docker Manager → Container Platform: manages containers
- Kubernetes Manager → Container Platform: orchestrates workloads
- Service Registry → Docker Manager: discovers services
- Application Entry → Security User: returns results
