S h a y d Z Super Monitor v2

Ultimate Self-Learning Network Defense, Monitoring, and AI Threat Intelligence Dashboard

🔥 What's New in v2

✅ Enhanced Error Handling: Robust error handling throughout the application
✅ Security Improvements: Added security headers and input validation
✅ Better Logging: Enhanced logging with file rotation and structured output
✅ Containerized Support: Improved compatibility for Docker/containerized environments
✅ Real-time Anomaly Detection: Self-learning baselines with live anomaly detection
✅ Production Ready: Cleaned up codebase with proper error handling and security features

📋 About

S h a y d Z Super Monitor v2 is a next-generation, self-learning network defense and threat intelligence system designed for cybersecurity professionals, home lab enthusiasts, and anyone serious about network monitoring.

🎯 Key Capabilities:

🤖 AI-Powered Anomaly Detection: Self-learning baselines that adapt to your network
🔒 Security-First Design: Built with security headers, input validation, and secure authentication
🌐 Cross-Platform: Runs seamlessly on Raspberry Pi, Linux, Windows, and macOS
📊 Real-time Monitoring: Live system metrics with interactive web dashboard
🔍 Threat Intelligence: Automated feeds from multiple security sources
🎨 Modern UI: Clean, responsive web interface with real-time charts

🚀 Features

📊 System Monitoring

CPU, RAM, Disk Usage: Real-time system resource monitoring
Temperature Monitoring: Hardware temperature tracking (with containerized simulation)
Network Connectivity: Multi-host ping monitoring with fallback methods
Failed Login Detection: Security event monitoring and analysis
Self-Learning Baselines: Automatic baseline establishment and anomaly detection

🔐 Security Features

Secure Authentication: bcrypt password hashing with session management
Security Headers: XSS protection, content-type validation, frame options
Input Validation: File type validation and path sanitization
Audit Logging: Comprehensive logging of all security events
Anomaly Alerts: Real-time alerts for suspicious activities

🌐 Web Dashboard

Real-time Charts: Interactive monitoring graphs using Chart.js
Responsive Design: Mobile-friendly interface with dark theme
File Downloads: Secure log file download with metadata
Settings Management: User-friendly configuration interface
Error Handling: Graceful error handling with user-friendly messages

🤖 AI Integration

Local Assistant: Privacy-focused local analysis and reporting
OpenAI Integration: Optional cloud AI for advanced threat analysis
Threat Intelligence: Automated feeds from CISA, security blogs, and threat databases
Smart Alerts: Context-aware alerting based on system behavior

📱 Hardware Integration

E-paper Display: Real-time status display on Waveshare 2.13" V3 (Pi/Linux)
Cross-platform Alerts: Desktop notifications or console output
GPIO Support: Hardware integration for Raspberry Pi deployments
Automated Actions: Configurable responses to security events

🛠️ Installation & Setup

📦 Prerequisites

Python 3.8+ (recommended 3.10+)
pip package manager
Internet connection for threat intelligence feeds

🚀 Quick Start

Clone the repository:

git clone https://github.com/shaydz93/shaydz-super-monitor-v2.git
cd shaydz-super-monitor-v2

Install dependencies:
```
pip install -r requirements.txt
```

Setup configuration:

cp config.json.example config.json
# Edit config.json with your preferred settings

Start the application:
```
python shaydz.py
```
Access the web dashboard:
- Open http://localhost:5001 in your browser
- Default credentials: admin / admin
- ⚠️ Change default password immediately after first login

🐳 Docker Deployment (Recommended for Production)

# Build the container
docker build -t shaydz-monitor .

# Run with persistent data
docker run -d \
  --name shaydz-monitor \
  -p 5001:5001 \
  -v $(pwd)/logs:/app/logs \
  -v $(pwd)/data:/app/data \
  shaydz-monitor

🔧 Advanced Installation

For Raspberry Pi with auto-startup:

# Install with systemd service
sudo bash install.sh

# Enable auto-start
sudo systemctl enable shaydz-monitor
sudo systemctl start shaydz-monitor

📊 Usage

🎛️ Web Dashboard

Dashboard: Real-time system metrics and anomaly detection
Downloads: Access to log files and system reports
Settings: User management and system configuration
Alerts: Real-time security alerts and anomaly notifications

📈 Monitoring Features

Real-time Metrics: Live CPU, RAM, disk, temperature, and network stats
Anomaly Detection: Self-learning baselines with automatic anomaly detection
Historical Data: Time-series charts showing system trends
Security Events: Failed login attempts and security incident tracking

🔍 Threat Intelligence

Automated Feeds: Regular updates from security sources
IOC Monitoring: Indicator of Compromise detection
Threat Analysis: AI-powered threat assessment and recommendations
Security Advisories: Latest security alerts and vulnerabilities

🔧 Configuration

📁 Configuration Files

config.json.example - Example configuration file (copy to config.json and customize)
baseline.json - Self-learning baseline data (auto-generated)
logs/ - Application logs and audit trails

⚙️ Key Settings

{
  "monitoring": {
    "window_size": 60,
    "update_interval": 5,
    "anomaly_threshold": 3
  },
  "security": {
    "session_timeout": 3600,
    "max_login_attempts": 5
  },
  "alerts": {
    "high_temp_threshold": 80,
    "email_notifications": false
  }
}

🔐 Security

🛡️ Security Features

Password Hashing: bcrypt with salt for secure password storage
Session Management: Secure session handling with timeout
Input Validation: All user inputs are validated and sanitized
Security Headers: Protection against common web vulnerabilities
Audit Logging: Complete audit trail of all security events

⚠️ Security Recommendations

Change default credentials immediately after installation
Use HTTPS in production environments
Regularly update dependencies and system packages
Monitor logs for suspicious activities
Backup configuration and baseline data regularly

📱 Platform Compatibility

Platform	Core Features	Hardware Features	Notes
Raspberry Pi	✅ Full Support	✅ E-paper, GPIO, Shutdown	Recommended platform
Linux	✅ Full Support	✅ Temperature, System Actions	Excellent compatibility
Windows	✅ Full Support	🔄 Desktop Notifications	PowerShell integration
macOS	✅ Full Support	🔄 Desktop Notifications	Native compatibility
Docker	✅ Full Support	🔄 Simulated Hardware	Containerized deployment

🧪 Testing

Run the comprehensive test suite:

python test_shaydz.py

Test individual components:

# Test monitoring
python -c "from ai_monitor import SelfLearningMonitor; m = SelfLearningMonitor(); m.update(); print('OK')"

# Test web UI
python -c "from web_ui import app; print('Web UI OK')"

# Test display
python -c "from display import EPDDisplay; d = EPDDisplay(); d.display_text(['Test']); print('Display OK')"

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

🐛 Bug Reports

Use the Issues tab
Include system information and error logs
Provide steps to reproduce the issue

💡 Feature Requests

Check existing Issues first
Describe the feature and use case
Include implementation suggestions if possible

🔧 Development Setup

# Clone and setup development environment
git clone https://github.com/shaydz93/shaydz-super-monitor-v2.git
cd shaydz-super-monitor-v2
pip install -r requirements.txt

# Run tests
python test_shaydz.py

# Start development server
python shaydz.py

📝 License

MIT License - see LICENSE for details.

🏆 Credits

Inspired by: Open-source blue-team and threat intelligence tools
AI Integration: OpenAI (optional)
Security Frameworks: OWASP security best practices
Community: Thanks to all contributors and security researchers

📞 Support

📚 Documentation: Wiki
💬 Discussions: GitHub Discussions
🐛 Issues: Bug Reports
📧 Contact: security@shaydz.com

🔥 Monitor smarter. Defend deeper. Secure your network with S h a y d Z Super Monitor v2! 🔥

Name		Name	Last commit message	Last commit date
Latest commit History 8 Commits
static		static
templates		templates
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
LICENSE		LICENSE
PROJECT_STRUCTURE.md		PROJECT_STRUCTURE.md
README.md		README.md
ai_monitor.py		ai_monitor.py
assistant.py		assistant.py
config.json.example		config.json.example
config_manager.py		config_manager.py
display.py		display.py
docker-compose.yml		docker-compose.yml
install.sh		install.sh
logging_config.py		logging_config.py
requirements.txt		requirements.txt
shaydz.py		shaydz.py
test_shaydz.py		test_shaydz.py
threat_intel.py		threat_intel.py
web_ui.py		web_ui.py

License

shaydz93/shaydz-super-monitor-v2

Folders and files

Latest commit

History

Repository files navigation