{"id":28998854,"url":"https://github.com/rajm012/netsentinel","last_synced_at":"2026-05-09T02:17:58.664Z","repository":{"id":299590479,"uuid":"962872493","full_name":"rajm012/NetSentinel","owner":"rajm012","description":"Real-time Network Traffic Monitoring and Threat Detection Platform Built using React, FastAPI, Scapy, and modern data visualization tools.","archived":false,"fork":false,"pushed_at":"2025-06-17T09:27:02.000Z","size":28961,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-25T03:22:13.385Z","etag":null,"topics":["fastapi","javascript","python"],"latest_commit_sha":null,"homepage":"https://net-sentinel-three.vercel.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rajm012.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-08T20:00:14.000Z","updated_at":"2025-06-17T09:27:05.000Z","dependencies_parsed_at":"2025-06-17T10:36:34.958Z","dependency_job_id":null,"html_url":"https://github.com/rajm012/NetSentinel","commit_stats":null,"previous_names":["rajm012/netsentinel"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rajm012/NetSentinel","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rajm012%2FNetSentinel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rajm012%2FNetSentinel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rajm012%2FNetSentinel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rajm012%2FNetSentinel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rajm012","download_url":"https://codeload.github.com/rajm012/NetSentinel/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rajm012%2FNetSentinel/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32804672,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"online","status_checked_at":"2026-05-09T02:00:06.633Z","response_time":123,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fastapi","javascript","python"],"created_at":"2025-06-25T07:39:33.183Z","updated_at":"2026-05-09T02:17:58.644Z","avatar_url":"https://github.com/rajm012.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🛡️ NetSentinel\n\n\u003e Real-time Network Traffic Monitoring and Threat Detection Platform Built using **React**, **FastAPI**, **Scapy**, and **modern data visualization tools**.\n\n---\n\n## 🌐 Overview\n\nNetSentinel is a full-stack cybersecurity dashboard for real-time and historical network analysis. From live packet capture to behavioral threat intelligence and PCAP testbeds, NetSentinel aims to offer a modular, interactive, and extendable NIDS-like system with a beautiful UI and intuitive controls.\n\n---\n\n## 🚀 Features at a Glance\n\n- 🌍 **Real-time network traffic visualization**\n- 📦 **Upload and analyze PCAPs**\n- 🔍 **Behavioral \u0026 fingerprint-based threat detection**\n- 🧠 **AI/ML-enabled traffic analysis (WIP)**\n- 📊 **Dashboards with live charts, GeoMaps, and protocol breakdowns**\n- 🧪 **Built-in packet testbed for simulation \u0026 replay**\n- 🔧 **Fully configurable via UI panel**\n- 🌙 **Dark/light theme support**\n\n---\n\n## 🏗️ Web Structure \u0026 Views\n\n### 🏠 Home Page (Landing Page)\n\n**URL:** `/`  \nThe gateway to the platform, includes:\n\n- Project name, logo, and description  \n- CTA buttons:\n  - ➡️ Dashboard\n  - 📜 View Docs\n  - 🔐 Admin/Login (optional)\n\n---\n\n### 📊 Dashboard Layout\n\n**URL:** `/dashboard`  \nYour main workspace.\n\n#### 🧭 Sidebar Navigation:\n\n- 🟢 Real-Time View\n- 📁 Historical Data\n- 🧠 Threat Intel\n- ⚙️ Configuration\n- 🧪 Packet Testbed\n- 📦 Raw Logs / PCAP Upload\n- 📜 Docs\n- 👤 Profile\n\n#### 🔝 Top Bar Controls:\n\n- Capture status (live/offline)\n- Interface selector\n- Notification bell\n- Timestamp\n- Dark/light theme toggle\n\n---\n\n### 🔴 Real-time View\n\n**URL:** `/dashboard/realtime`  \nA live window into your network:\n\n- Packet stream viewer (filterable)\n- 🚨 Alert Feed\n- 🌍 GeoMap of IP origins\n- 🥧 Protocol distribution chart\n- 📈 Time-series flow chart\n- 🎛️ Capture control bar\n- Toggle: Raw packets ↔️ Flow-based view\n\n**Tech Used:**  \n- WebSocket + Redux  \n- FastAPI + Scapy/tshark backend\n\n---\n\n### 🧾 Historical View\n\n**URL:** `/dashboard/historical`  \nInspect past logs, alerts, and flows.\n\n- Load from PCAP or JSON logs\n- Use `FilterBuilder.jsx` to query\n- Export sessions or alerts\n- Inspect historical packet sequences\n\n---\n\n### 🔍 Threat Intelligence\n\n**URL:** `/dashboard/threatintel`  \nAI and rule-based threat breakdown:\n\n- Behavior-based detection (e.g., scanning, burst patterns)\n- Device and protocol fingerprinting (TLS/HTTP/etc.)\n- Known threat tool detection (Metasploit, CobaltStrike)\n- Severity filters: 🔵 Low | 🟡 Medium | 🔴 High\n- Drill-down per alert → View associated packets\n\n---\n\n### 🛠️ Configuration Panel\n\n**URL:** `/dashboard/config`\n\nModify how your engine behaves:\n\n- Detection thresholds \u0026 toggles\n- Capture interface selection\n- Logging format, location \u0026 frequency\n- Alert channels (email/webhook)\n- Time ranges (`TimeRangeSelector.jsx`)\n\n---\n\n### 🧪 Testbed / Packet Replay\n\n**URL:** `/dashboard/testbed`  \nSimulate attacks and test detection logic:\n\n- Upload PCAPs\n- Replay through detector engine\n- Compare triggered alerts vs ground truth\n\n---\n\n### 📦 Packet Details View\n\n**URL:** `/packet/:id` (or modal popup)\n\nWhenever a packet or alert is clicked:\n\n- Layered packet parsing (Ethernet, IP, TCP, etc.)\n- Hex dump view\n- Associated alerts/anomalies\n- Source/Dest GeoIP\n- Timeline correlation with other packets\n\n---\n\n## ⚙️ Tech Stack\n\n| Layer        | Stack                            |\n| ------------ | -------------------------------- |\n| Frontend     | React + Tailwind + Recharts      |\n| Backend      | FastAPI + Scapy/tshark           |\n| Real-Time    | WebSocket + Redux                |\n| Visualization| GeoMap (Leaflet/D3), Recharts    |\n| Data Format  | PCAP, JSON, Parquet (ML)         |\n| Auth (Opt.)  | JWT / OAuth (planned)            |\n\n---\n\n## 🧪 Running the App (Dev Mode)\n\n```bash\n# Backend\ncd backend\nuvicorn main:app --reload\n\n# Frontend\ncd frontend\nnpm install\nnpm run dev\n```\n\n---\n\n## 📈 Future Plans\n\n- ✅ Packet-level anomaly detection using ML/DL\n- 🔍 DPI and App-layer analytics\n- 🔐 Admin dashboard and audit logs\n- 📊 Elasticsearch or ClickHouse backend for scalable storage\n- 🧠 Integrate Deep Learning models like FNO for traffic prediction\n\n---\n\n## 📜 License\n\nMIT License — feel free to fork, contribute, and make it your own!\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frajm012%2Fnetsentinel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frajm012%2Fnetsentinel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frajm012%2Fnetsentinel/lists"}