Skip to content

nishupr/CyberSentry

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🛡️ CyberSentry

Autonomous Red Team AI Agent & Security Engineering Pipeline

CyberSentry is a fully local, AI-powered security engineering tool designed to scan codebases, triage vulnerabilities, debate remediation strategies, and generate patches — without any source code ever leaving your machine.

It includes:

💻 CLI Tool 🌐 Web Dashboard (Mission Console) 🧩 Browser Extension for live scanning 🔥 Features 🧠 Multi-Scanner Architecture Runs Bandit (Python security analysis) Runs Semgrep (OWASP Top 10 rule-based scanning) Executes scans concurrently for better performance 📊 Intelligent Triage Engine Groups raw findings into root-cause clusters Assigns a Risk Score (0.0 – 1.0) Highlights critical vulnerabilities for prioritization 🤖 Multi-Agent Remediation Debate

CyberSentry simulates a real security team:

🔴 Red Team Agent Suggests deep, defense-in-depth architectural fixes 🔵 Blue Team Agent Suggests minimal, production-safe fixes 📋 Auditor Agent Validates solutions using OWASP ASVS compliance ⚖️ Judge Agent Scores solutions on: Security Safety Maintainability Compliance Effort

👉 Declares the best remediation strategy

🛠️ Auto-Patching Engine Generates unified diffs from the winning strategy Uses dry-run by default Requires human approval before applying changes 🌐 Mission Console (Web UI)

Built with FastAPI, featuring:

✨ Glassmorphism UI 🔍 URL Scanner 💬 Security Chat Assistant 📡 Live Agent Monitoring 🧩 Browser Extension One-click passive web scanning Checks: Insecure transport Cookie flags CSP Missing headers 🚀 Getting Started

  1. Requirements Python 3.10+ Ollama (must be running locally) Chrome / Edge (for extension)
  2. Installation

Clone the repository

git clone https://github.com/nishupr/CyberSentry.git

cd cybercentry/cyber_sentry

Create virtual environment

python -m venv .venv

Activate environment

Windows:

.venv\Scripts\activate

Mac/Linux:

source .venv/bin/activate

Install dependencies

pip install -e . 3. Basic Setup

Initialize config

cs init .

Check environment setup

cs doctor 💻 CLI Usage

Start interactive agent

cs chat Commands Command Description /scan Scan file/directory /findings View vulnerabilities /triage Cluster & prioritize /debate Run multi-agent debate /patch [--apply] Generate/apply fix /tools View available tools 🌐 Mission Console (Web UI) cs ui --port 8081

Open in browser:

http://localhost:8081 Features: 🔍 URL Scanner 💬 Security Chat 🧠 Agent Console 🧩 Browser Extension Setup Open chrome://extensions Enable Developer Mode Click Load Unpacked Select chrome_extension folder

👉 Click extension → Scan This Page

🛡️ Privacy First ✅ 100% local execution ❌ No external API keys required ❌ No data sent to cloud 🤖 Powered by Qwen 2.5 Coder via Ollama ⭐ Why CyberSentry?

Because modern security needs:

Automation ⚡ Intelligence 🧠 Privacy 🔒

CyberSentry delivers all three — locally.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors