Network Architecture Diagrams

Python scripts to generate network architecture diagrams using the Diagrams library.

Prerequisites

• Python 3.8+
• Graphviz (installation guide)

Installing Graphviz

Windows:

choco install graphviz
# or download from https://graphviz.org/download/

macOS:

brew install graphviz

Linux:

sudo apt-get install graphviz  # Debian/Ubuntu
sudo yum install graphviz      # RHEL/CentOS

Setup

1. Create a virtual environment:

python -m venv .venv

2. Activate the virtual environment:

# Windows
.venv\Scripts\activate

# macOS/Linux
source .venv/bin/activate

3. Install dependencies:

pip install -r requirements.txt

Usage

Run the diagram generation scripts:

# Generate LAN architecture diagram
python lan_architecture.py

# Generate main diagram
python main.py

Output files will be generated in the current directory as PNG images.

Available Diagrams

Network Topology Viewer

A modern, interactive network topology visualization tool built with D2 diagrams.

Features

• Interactive network diagram with pan/zoom
• Real-time node details and tooltips
• Clean, modern UI with dark theme
• Export capabilities

Running with Docker

Build and run:

• lan_architecture.py - Home Lab / Auction Stack Architecture diagram
• main.py - Network architecture diagram

Deployment

To deploy or share this project:

1. Ensure Graphviz is installed on the target system
2. Clone the repository
3. Follow the setup instructions above
4. Run the desired diagram script

Notes

• Generated diagram files (.png, .gv) are excluded from version control
• The diagrams use a left-to-right (LR) layout direction
• Output files are saved with show=False to prevent automatic opening