https://github.com/drhazemali/cyberpulse
CyberPulse AI bridges AI and cybersecurity for advanced, real-time threat detection.
https://github.com/drhazemali/cyberpulse
ai azure cybersecurity
Last synced: about 1 month ago
JSON representation
CyberPulse AI bridges AI and cybersecurity for advanced, real-time threat detection.
- Host: GitHub
- URL: https://github.com/drhazemali/cyberpulse
- Owner: DrHazemAli
- License: mit
- Created: 2025-05-31T01:08:56.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-31T01:17:31.000Z (about 1 year ago)
- Last Synced: 2025-05-31T12:00:21.401Z (about 1 year ago)
- Topics: ai, azure, cybersecurity
- Language: Python
- Homepage:
- Size: 1.22 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🚀 CyberPulse AI
**CyberPulse AI** is a next-generation, AI-powered security monitoring system that **detects anomalies**, **analyzes threats**, and **provides real-time insights** to protect your digital assets.
Designed for **production use** with **cloud-native architecture**, **Docker support**, **CI/CD pipelines**, and **state-of-the-art AI models**.
## 🌐 What is CyberPulse AI?
CyberPulse AI watches over your network, systems, and data like a heartbeat monitor for your digital world.
It uses advanced AI models, cloud services, and a user-friendly interface to detect security threats **before they strike**.
---
## 🏗️ Architecture
```
+------------------------------------+
| User & Data Sources |
| (AD, Firewalls, NSGs, Custom Logs) |
+------------------------------------+
|
v
+------------------------------------+
| Azure Event Hubs (Streaming) |
+------------------------------------+
|
v
+------------------------------------+
| AI Anomaly Detection Models |
| (Isolation Forest, LOF, OCSVM) |
| Deployed via Azure ML API |
+------------------------------------+
|
v
+------------------------------------+
| CyberPulse AI Backend (API) |
| REST API | Flask GUI | CLI |
+------------------------------------+
|
v
+------------------------------------+
| Azure Sentinel + Log Analytics |
| Prometheus + Grafana Dashboards |
+------------------------------------+
```
---
## 🚀 Features
✅ **AI-Powered Threat Detection**: Isolation Forest, Local Outlier Factor, One-Class SVM.
✅ **Azure-Native**: Sentinel, Event Hubs, ML, Key Vault (configurable).
✅ **Real-Time Dashboards**: Prometheus + Grafana, pre-configured templates.
✅ **REST API**: Expose services via FastAPI with SSL/TLS support.
✅ **CLI Tools**: Automate Azure setup, dataset downloads, and more.
✅ **Docker-Ready**: Run the entire stack in containers.
✅ **CI/CD Pipelines**: GitHub Actions workflows included.
✅ **Deployment Guide**: Step-by-step instructions for setup.
✅ **Extensible Architecture**: Add models, data sources, and integrations.
---
## 📂 Repository Structure
```
/CyberPulse-AI
|-- azure-functions/ # Event Hub consumer code
|-- azure-ml/ # ML training & scoring
|-- cli.py # CLI interface
|-- api.py # REST API (FastAPI)
|-- gui/ # Flask GUI
|-- datasets/ # Sample data
|-- reports/ # Generated reports
|-- monitoring/ # Prometheus & Grafana configs
|-- deployment/ # Deployment scripts & guides
|-- Dockerfile # Docker container setup
|-- docker-compose.yml # Orchestrated deployment
|-- requirements.txt # Python dependencies
|-- .github/workflows/ # CI/CD pipelines
|-- README.md # This file!
```
---
## 🛡️ Security & Best Practices
- **Secrets Management**: Use `.env` and `Azure Key Vault` for credentials.
- **RBAC & Access Control**: Integrate with Azure AD for role-based permissions.
- **SSL/TLS**: Secure API endpoints with HTTPS.
- **Monitoring**: Real-time metrics with Prometheus & Grafana.
- **Alerting**: Azure Sentinel rules + custom queries.
---
## 🛠️ Deployment Steps
1️⃣ **Azure Setup**:
```bash
bash deployment/deploy_azure.sh
```
2️⃣ **Docker Build & Run**:
```bash
docker build -t cyberpulse-ai .
docker-compose up
```
3️⃣ **API & Reports**:
```bash
python api.py
python generate_report.py
```
4️⃣ **Grafana**: Import `monitoring/dashboards/cyberpulse_dashboard.json`.
---
## 📊 Dashboards
| Service | URL | Default Credentials |
|------------|------------------------|---------------------|
| Flask GUI | http://localhost:5000 | - |
| Grafana | http://localhost:3000 | admin / admin |
| Prometheus | http://localhost:9090 | - |
---
## 📈 Extending CyberPulse AI
- Add ML models in `azure-ml/train_model.py`.
- Configure API endpoints in `api.py`.
- Create new CLI commands in `cli.py`.
- Expand datasets in `datasets/`.
- Define new dashboards in `monitoring/dashboards/`.
---
## 🎓 License & Credits
© Hazem Ali | 2025
GitHub: [DrHazemAli](https://github.com/DrHazemAli)
Licensed under the MIT License.
---
🚀 Stay vigilant. Stay secure. Welcome to CyberPulse AI.