Skip to main content

🛡️ HackBoard

Professional Cybersecurity Intelligence Platform

Python Streamlit License Version

╔══════════════════════════════════════════════════════════════════════╗
║                                                                      ║
║     ██╗  ██╗ █████╗  ██████╗██╗  ██╗██████╗  ██████╗  █████╗ ██████╗  ║
║     ██║  ██║██╔══██╗██╔════╝██║ ██╔╝██╔══██╗██╔═══██╗██╔══██╗██╔══██╗ ║
║     ███████║███████║██║     █████╔╝ ██████╔╝██║   ██║███████║██║  ██║ ║
║     ██╔══██║██╔══██║██║     ██╔═██╗ ██╔══██╗██║   ██║██╔══██║██║  ██║ ║
║     ██║  ██║██║  ██║╚██████╗██║  ██╗██████╔╝╚██████╔╝██║  ██║██████╔╝ ║
║     ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝╚═════╝  ╚═════╝ ╚═╝  ╚═╝╚═════╝  ║
║                                                                      ║
║              CYBERSECURITY INTELLIGENCE PLATFORM                      ║
╚══════════════════════════════════════════════════════════════════════╝

📖 Overview

HackBoard is a professional cybersecurity intelligence platform designed for educational, defensive, and ethical hacking purposes. Built as a futuristic cyberpunk SOC dashboard, it combines AI-inspired security analysis, advanced network scanning, OSINT intelligence, threat analytics, and comprehensive reporting — all within an immersive Streamlit interface.

Key Capabilities

  • 🤖 AI Security Insights — Contextual AI-like analysis across all security vectors
  • 🔍 Network Scanner — Safe TCP port scanning with topology visualization
  • 🌐 OSINT Intelligence — WHOIS, DNS, SSL, subdomain enumeration
  • 🔐 Password Analyzer — Entropy scoring with pattern detection
  • 🧪 Hashing Laboratory — 8 algorithms, file/text hashing, integrity verification
  • 📁 File Security Analyzer — Static analysis with entropy and magic bytes
  • ⚠️ Vulnerability Assessment — Simulated CVSS scoring and recommendations
  • 📊 Packet Analytics — Protocol distribution and traffic visualization
  • 🧠 Threat Intelligence — Kill chain visualization and threat radars
  • 💻 System Monitor — Real-time CPU, RAM, disk, and process telemetry

🚀 Installation

Prerequisites

  • Python 3.9+
  • pip package manager
  • Git (for cloning)

Quick Install (pip)

pip install hackboard

Development Install (from source)

git clone https://github.com/issu321/hackboard.git
cd hackboard
pip install -e .

Linux / Kali Linux / Ubuntu / Debian

git clone https://github.com/issu321/hackboard.git
cd hackboard
bash install.sh

The installer will:

  1. ✅ Detect Python and pip
  2. ✅ Check virtual environment
  3. ✅ Create ~/.config/hackboard/ directories
  4. ✅ Install all dependencies
  5. ✅ Launch HackBoard automatically

System dependencies (if scapy fails):

sudo apt-get update
sudo apt-get install -y libpcap-dev

Windows 10 / 11

git clone https://github.com/issu321/hackboard.git
cd hackboard
pip install -e .

Note for Windows:

  • Install Npcap for full packet capture features
  • Run as Administrator for raw socket operations
  • The app gracefully falls back to simulated data without admin rights

🖥️ Usage

Launch the Dashboard

# After pip install
hackboard

# Or with options
hackboard --port 8080 --host 0.0.0.0
hackboard --no-browser

# Or as a Python module
python -m hackboard

CLI Options

usage: hackboard [-h] [--version] [--port PORT] [--host HOST] [--no-browser] [--headless] [--config-dir]

HackBoard — Professional Cybersecurity Intelligence Platform

options:
  -h, --help       Show this help message and exit
  --version, -v    Show version and exit
  --port PORT, -p PORT
                   Port to run the Streamlit server on (default: 8501)
  --host HOST, -H HOST
                   Host to bind the server to (default: localhost)
  --no-browser, -n
                   Do not open browser automatically
  --headless       Run in headless mode
  --config-dir     Print the configuration directory path and exit

📸 Screenshots

Screenshots will be added here. The dashboard features:

  • Animated terminal boot sequence
  • Live SOC feed with simulated alerts
  • Interactive Plotly charts with cyberpunk dark theme
  • Network topology node graphs
  • Risk gauges and system telemetry

🧩 Features

Module Description
🏠 Dashboard Central command center with live metrics, threat radar, attack chain
🔍 Network Scanner TCP port scanning with topology maps and risk scoring
🌐 Domain Intelligence WHOIS, DNS, SSL certificate analysis
📡 Subdomain Intelligence Subdomain enumeration with relationship graphs
🔐 Password Analyzer Entropy & strength analysis with AI recommendations
🧪 Hashing Laboratory Multi-algorithm hashing (MD5, SHA family, BLAKE2)
📁 File Security Analyzer Upload & analyze file security with static analysis
⚠️ Vulnerability Intelligence Simulated vulnerability assessment with CVSS
📊 Packet Analytics Network traffic visualization and protocol distribution
🧠 Threat Intelligence Attack chains, threat radars, and heatmaps
💻 System Monitor Real-time CPU, RAM, disk, and process monitoring
📂 Upload Center Import logs and data files (CSV, JSON, TXT, PCAP)
📥 Download Center Export reports in CSV, JSON, TXT formats
📈 Cyber Analytics Custom chart generation engine
🌍 DNS Intelligence Multi-record DNS lookups with visualization
🛰️ Network Topology Interactive node graphs from scan data
📋 Reports Center View and manage all generated reports
🤖 AI Security Insights Cross-domain AI analysis and correlation

🔌 Plugin Development

HackBoard supports a plugin architecture. Place Python files in the plugins/ directory and they will be automatically discovered and loaded.

Example Plugin

# plugins/my_plugin.py

PLUGIN_NAME = "My Plugin"
PLUGIN_VERSION = "1.0.0"
PLUGIN_DESCRIPTION = "A custom security plugin for HackBoard."


def register(app_context: dict) -> None:
    """Register the plugin with HackBoard."""
    print(f"[PLUGIN] {PLUGIN_NAME} v{PLUGIN_VERSION} loaded")
    # Add your custom logic here

Plugin Interface

  • PLUGIN_NAME (str): Human-readable plugin name
  • PLUGIN_VERSION (str): Plugin version
  • PLUGIN_DESCRIPTION (str): Brief description
  • register(app_context): Function called with the application context

🛠️ Developer Guide

Project Structure

hackboard/
├── hackboard/
│   ├── __init__.py          # Package init, version, config dirs
│   ├── __main__.py          # Entry point for python -m hackboard
│   ├── app.py               # Main Streamlit application (18 pages)
│   ├── cli.py               # CLI launcher (hackboard command)
│   ├── launcher.py          # Programmatic launch API
│   ├── security_tools.py    # Network scanner, password, hashing, file, vuln
│   ├── osint_tools.py       # WHOIS, DNS, subdomains, IP, SSL, metadata
│   ├── analytics.py         # Plotly charts, heatmaps, graphs, gauges
│   ├── utils.py             # Config, logging, exports, SOC feed, AI insights
│   ├── assets/
│   │   ├── banner.txt       # ASCII art banner
│   │   ├── styles.css       # Cyberpunk theme styles
│   │   └── animations.json  # Boot sequence & SOC alert configs
│   └── plugins/
│       ├── __init__.py
│       └── example_plugin.py
├── tests/
│   ├── __init__.py
│   ├── test_utils.py
│   └── test_security_tools.py
├── docs/
├── config/
├── pyproject.toml           # Modern setuptools packaging
├── setup.cfg                # Backup setuptools config
├── MANIFEST.in              # Package manifest
├── requirements.txt         # Dependencies
├── install.sh               # Linux automated installer
├── LICENSE                  # MIT License
└── README.md                # This file

Configuration

HackBoard stores user settings in ~/.config/hackboard/:

~/.config/hackboard/
├── logs/           # Rotating application logs
├── reports/        # Auto-saved reports (YYYY-MM-DD/)
├── history/        # Threat logs and session history
└── settings/       # User preferences

Logging

Logs are automatically written to ~/.config/hackboard/logs/hackboard.log with rotation (5 backups, 5MB each).

from hackboard.utils import logger
logger.info("Custom log message")

Running Tests

pytest
# Or with coverage
pytest --cov=hackboard --cov-report=html

Code Style

# Format with black
black hackboard/

# Type check with mypy
mypy hackboard/

# Lint with flake8
flake8 hackboard/

🛡️ Ethical Hacking Disclaimer

╔════════════════════════════════════════════════════════════════╗
║  THIS PROJECT IS STRICTLY FOR EDUCATIONAL AND DEFENSIVE USE  ║
║  ONLY.                                                         ║
║                                                                ║
║  • Only scan systems you OWN or have WRITTEN AUTHORIZATION    ║
║    to test.                                                    ║
║  • All tools are designed for AUTHORIZED LAB ENVIRONMENTS.    ║
║  • No malware, ransomware, or destructive payloads included.  ║
║  • No credential theft or illegal persistence mechanisms.       ║
║  • Use responsibly and in compliance with all applicable laws. ║
╚════════════════════════════════════════════════════════════════╝

By using this software, you agree to use it only on systems you own or have explicit permission to test, and for learning, teaching, and defensive hardening only.


📦 Packaging

pip Install (Local)

cd hackboard
pip install .

pip Install (Editable)

cd hackboard
pip install -e .

Build Distribution

cd hackboard
python -m build

This produces dist/hackboard-1.0.0-py3-none-any.whl and dist/hackboard-1.0.0.tar.gz.

APT Package (Future)

The project is structured to be easily converted to a Debian package:

# Future command
sudo apt install hackboard

The install.sh script and pyproject.toml provide the foundation for APT packaging.


🗺️ Future Roadmap

  • Real-time packet capture with Scapy integration (admin mode)
  • CVE database integration for live vulnerability lookup
  • Shodan API integration for internet-facing asset discovery
  • MITRE ATT&CK mapping for threat intelligence
  • PDF report generation with professional formatting
  • Multi-language support (internationalization)
  • Dark/Light theme toggle
  • User authentication and session management
  • REST API endpoint for programmatic access
  • Docker containerization for one-click deployment
  • APT package for Debian/Ubuntu/Kali Linux

🤝 Contributing

We welcome contributions from the cybersecurity community!

  1. Fork the repository
  2. Create a branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Guidelines

  • All contributions must remain educational and defensive
  • No malicious or destructive code will be accepted
  • Follow PEP 8 style guidelines
  • Add docstrings to all functions
  • Ensure cross-platform compatibility (Linux & Windows)

📜 License

This project is licensed under the MIT License. See LICENSE for details.

MIT License

Copyright (c) 2024-2026 issu321

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

👤 Developer

Developed by issu321

GitHub Repository


╔══════════════════════════════════════════════════════════════════════╗
║     STAY ETHICAL.  STAY CURIOUS.  STAY SECURE.                      ║
║                                                                      ║
║     HackBoard — Cybersecurity Intelligence Platform                   ║
║     Developed by issu321                                              ║
╚══════════════════════════════════════════════════════════════════════╝

⭐ Star this repo if you find it useful! ⭐

Metadata

Release files for hackboard-ussu321 1.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hackboard-ussu321 1.0.2
File Size Uploaded Provenance Actions
hackboard_ussu321-1.0.2.tar.gz 68.4 kB Without provenance Details for hackboard_ussu321-1.0.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for hackboard-ussu321 1.0.2
File Interpreter ABI Platform Actions
hackboard_ussu321-1.0.2-py3-none-any.whl Python 3 none any Details for hackboard_ussu321-1.0.2-py3-none-any.whl

Total release size: 130.1 kB

Release files / hackboard_ussu321-1.0.2.tar.gz

Download URL hackboard_ussu321-1.0.2.tar.gz
Size 68.4 kB
Tags Source
SHA-256 checksum
How to use checksums
e9a6f6d8cbd4393ea2b5bf70daacbf8e0c29bec2c97130bd57d9e74b483da1ca
BLAKE2b-256 checksum
How to use checksums
d4c4b0fe040369096ca0b72e4591f03aef67b5d344bcfcfdb7183b7f7c09127f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.14

Release files / hackboard_ussu321-1.0.2-py3-none-any.whl

Download URL hackboard_ussu321-1.0.2-py3-none-any.whl
Size 61.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
83718813870d65ee68e4410178e31bdecadc2af00fa4a82e06d9008edfae8e19
BLAKE2b-256 checksum
How to use checksums
2522ad9bdd8f6dea8905e3b779854bfdc443cfaf1e422425944b67304495c21d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.14

Security for hackboard-ussu321 1.0.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page