AI‑Assisted Defensive Security Scanning & Reporting Framework
Educational • Research • Blue‑Team Focused
RedSentinel is an AI‑assisted security assessment tool that orchestrates well‑known defensive scanners, normalizes their output, enriches findings with risk context, and generates professional‑grade HTML, PDF, and JSON reports.
It is designed for:
- Blue teams
- Security students
- Researchers
- Defensive assessments
🚫 No exploitation. No payloads. No intrusion.
Step-by-step installation and first-run demonstration of the RedSentinel CLI.
- Live execution of industry‑standard scanners
- Confidence‑weighted findings
- CVSS‑based severity scoring
- AI‑generated remediation roadmap
- Compliance mapping (OWASP, ISO 27001, PCI DSS)
- Risk heatmap visualization
- HTML, PDF & JSON reporting
- Termux‑aware execution
Sample reports are included in the project root:
reports/
├── report_karlseyra.html
├── report_karlseyra.pdf
└── report_karlseyra.json
These demonstrate RedSentinel's reporting format and structure.
# For Linux (Debian/Ubuntu):
# sudo apt update && sudo apt install git nmap nikto whatweb sslscan
# For macOS:
# brew install git nmap sslscan perl ruby
#
# Manual installation for nikto and whatweb on macOS:
# cd ~ && git clone https://github.com/sullo/nikto.git
# echo 'export PATH=$PATH:~/nikto/program' >> ~/.zshrc
# cd ~ && git clone https://github.com/urbanadventurer/WhatWeb.git
# echo 'export PATH=$PATH:~/WhatWeb' >> ~/.zshrc
# source ~/.zshrc
git clone https://github.com/hackura/RedSentinel.git
cd RedSentinel
python3 -m venv venv
source venv/bin/activate
pip install -e .pkg update && pkg upgrade
pkg install python git clang openssl libxml2 libxslt golang perl ruby
pkg install nmap sslscan
# Install httpx
go install github.com/projectdiscovery/httpx/cmd/httpx@latest
# Install nikto (manual)
cd ~
git clone https://github.com/sullo/nikto.git
echo 'export PATH=$PATH:~/nikto/program' >> ~/.bashrc
# Install whatweb (manual)
cd ~
git clone https://github.com/urbanadventurer/WhatWeb.git
echo 'export PATH=$PATH:~/WhatWeb' >> ~/.bashrc
# Apply PATH changes
source ~/.bashrc
# Install RedSentinel
cd ~
git clone https://github.com/hackura/RedSentinel.git
cd RedSentinel
pip install --upgrade pip setuptools wheel
pip install -e .- PDF generation may be skipped
- ICMP may be restricted (nmap uses
-Pnautomatically) - Always install tools using
pkg, notapt - nikto and whatweb require manual installation from GitHub
- RedSentinel will skip unavailable tools automatically
Run the interactive CLI:
redsentinelRun a scan without generating reports:
redsentinel --no-reportFollow the interactive menu to run a scan and generate reports.
RedSentinel uses AI to:
- Summarize technical findings
- Generate prioritized remediation steps
- Translate raw scan data into executive‑friendly language
AI output never performs exploitation.
- GitHub: https://github.com/hackura
- Twitter / X: https://twitter.com/dorpe_karl
- LinkedIn: https://linkedin.com/in/karlseyramdorpe
RedSentinel aligns with established security standards:
-
OWASP Top 10 https://owasp.org/www-project-top-ten/
-
NIST SP 800‑53 / 800‑61 https://csrc.nist.gov/
-
CVSS v3.1 https://www.first.org/cvss/
-
MITRE ATT&CK https://attack.mitre.org/
These frameworks guide severity scoring, compliance mapping, and reporting logic.
If RedSentinel helps you learn or work better:
- ⭐ Star the repository
- ☕ Donate: https://buymeacoffee.com/hackura
- Share the project
- Contribute code or documentation
RedSentinel is intended for authorized defensive security testing only.
You must own the target or have explicit permission before scanning.
The authors are not responsible for misuse.
RedSentinel — Hackura Project Educational & Research Use Only