Skip to content

A machine learning model for Network Intrusion Detection System, this model detect malicious network packet in real time.

Notifications You must be signed in to change notification settings

codewithgabriel/mlguard

Repository files navigation

🛡️ MLGuard

MLGuard is a Network Intrusion Detection System (NIDS) powered by hybrid machine learning algorithms — combining the strengths of Random Forest and XGBoost to detect and classify potential security threats in network traffic.


🚀 Features

  • 🔍 Intelligent intrusion detection using ensemble ML models
  • ⚙️ Backend built with Python
  • 💻 Frontend powered by React + Vite
  • 📊 Real-time monitoring and analysis

⚙️ Quick Installation Guide

Step 1 — Activate the Virtual Environment

From the project’s root directory, activate your virtual environment:

Scripts/activate

(If you’re on Linux or macOS, the command may differ, e.g. source venv/bin/activate.)


Step 2 — Install Required Dependencies

Install all backend dependencies:

pip install -r requirements.txt

Step 3 — Run the Frontend (React + Vite)

Navigate to the frontend directory and start the development server:

cd frontend
npm install
npm run dev

🧠 Tech Stack

  • Machine Learning: Random Forest, XGBoost
  • Backend: Python
  • Frontend: React (Vite)
  • Environment Management: Virtualenv

📬 Contributions

Contributions, issues, and feature requests are welcome!
Feel free to submit a pull request or open an issue.


🧾 License

This project is released under the MIT License.

About

A machine learning model for Network Intrusion Detection System, this model detect malicious network packet in real time.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published