kharma-radar 10.2.14

Kharma Evolution: An elite proactive defense suite featuring real-time radar, DPI, Geo-Fencing, and automated malware termination.

Kharma_Radar

Elite Proactive Defense & Enterprise-Grade Network Intelligence

Kharma Evolution is an elite, proactive network defense suite designed to eliminate 'blind spots' in system visibility. It transforms raw network data into actionable security intelligence using real-time radar mapping, deep packet inspection (DPI), and automated malware termination.

---

🛡️ The Evolution of Defense

Kharma is not just a monitor; it's an Active Defense System. It acts as an all-seeing eye for your operating system, providing a stunning, high-performance radar that intercepts outbound connections, unmasks the executable initiating the socket, runs it against 70+ Anti-Virus engines in the cloud, and plots targets on a global map—all updated every 2 seconds.

---

🔥 Elite Features

• 🌐 Evolution Web Dashboard: A stunning glassmorphism interface serving real-time radar data, bandwidth charts, and security event logs.
• 📡 Deep Packet Inspection (DPI): Real-time protocol detection and signature matching to catch SQLi, XSS, and anomalous payloads.
• 🌍 Elite Geo-Fencing: Reactive nation-blocking. Automatically firewall-block entire countries from the dashboard with one click.
• 🦠 Enterprise EDR (VirusTotal): Natively extracts binary paths, computes SHA-256 hashes, and conducts cloud-based malware validation.
• ⚔️ Active Defense (Auto-Kill): Instantly terminates processes that connect to known malicious IPs or match flagged binary hashes.
• 🤖 Guardian Bot Alerts: Push critical breach alerts dynamically to Telegram or Discord as they happen.
• 🐝 Multi-Node Swarm: Federate multiple Kharma nodes into a single 'Hive' view for global enterprise oversight.
• 🛰️ Offline Geo-IP Engine: Powered by MaxMind GeoLite2 for 0ms lag resolution and 100% privacy.
• 🗄️ Time Machine Forensics: Persistent SQLite logging for detailed post-incident analysis and reporting.

---

🚀 Installation & Setup

🆕 Option 1: Standalone Portable EXE (Easiest)

Download the zero-dependency executable. No Python installation required!

• Download: kharma.exe (v10.2.4)
• Usage: Just double-click to run or use it from the command line.

🆕 Option 2: Smart Windows Installer (Automated)

Don't have Python? Our script will set it up for you using winget.

1. Download setup_windows.bat.
2. Right-click and Run as Administrator.
3. It will automatically install Python (if missing) and all dependencies.

🆕 Option 3: Docker (Containerized Dashboard)

The most secure way to run the Web Dashboard without touching your local Python environment.

docker build -t kharma-radar .
docker run --net=host -p 8085:8085 kharma-radar

(Requires --net=host to monitor the host machine's actual network interface).

🆕 Option 4: Homebrew (macOS & Linux)

brew install Mutasem-mk4/kharma-network-radar/kharma

🆕 Option 5: Snapcraft (Ubuntu & Others)

snap install kharma --classic

🆕 Option 6: Windows Winget (Official)

winget install Mutasem.KharmaEvolution

Option 6: Standard PyPI Install (For Developers)

pip install kharma-radar

If pip is not recognized, try: python -m pip install kharma-radar

---

💻 Quick Start Guide

Kharma is an intelligent CLI that relies on the incredibly styled rich-click interface. Run kharma --help at any time.

Command	Description
kharma run	Start the Live Network Radar Dashboard in the Terminal.
kharma run --protect	Start Dashboard + Auto-Kill Malware (Active Defense).
kharma web	Launch the Dark Web UI Dashboard (Localhost).
kharma daemon start	Deploy the silent Background Monitor.
kharma history	View historical connections (Time Machine).
kharma config vt <KEY>	Register a free VirusTotal API Key for advanced EDR.

🌍 The Web UI Dashboard

Get the ultimate Full-Stack experience visually tracking your network:

root@linux:~# kharma web --port 8080
[*] Initializing Kharma Web Dashboard...
[*] Spawning background data scanner loop...
[*] Dashboard launched at: http://127.0.0.1:8080

(Simply open your browser to the URL and watch the data flow!)

---

🏗️ Architecture

Kharma is designed for maximum performance, minimal dependencies, and absolute oversight.

• Frontend: rich (Terminal TUI) & Tailwind.css + JavaScript (Web UI).
• Backend Core: psutil (Socket Hooks), Flask (REST API).
• Persistence: Local SQLite for logging and .mmdb for GeoIP lookups.

---

---

🛠️ Troubleshooting

1. "'pip' or 'kharma' is not recognized..." (Windows)

This means Python is not in your System PATH.

• Fix: Re-install Python and check "Add Python to PATH" in the installer.
• Quick Workaround: Use python -m pip install kharma-radar and python -m kharma.

2. "Python was not found..."

You might have the "Windows App Execution Aliases" enabled.

• Fix: Go to Manage App Execution Aliases in Windows settings and turn OFF the aliases for python.exe and python3.exe.

---

🛡️ Disclaimer

Kharma is developed strictly for educational purposes, system administration, and defensive cybersecurity operations. The author is not responsible for any misuse or damage caused by terminating critical system processes via the Auto-Kill features.

Developed by Mutasem
Cybersecurity & Software Engineer