██████╗ ██████╗ ███╗   ███╗██████╗  █████╗ ██████╗ ███████╗
  ██╔════╝██╔═══██╗████╗ ████║██╔══██╗██╔══██╗██╔══██╗██╔════╝
  ██║     ██║   ██║██╔████╔██║██████╔╝███████║██║   ██║█████╗  
  ██║     ██║   ██║██║╚██╔╝██║██╔══██╗██╔══██║██║   ██║██╔══╝  
  ╚██████╗╚██████╔╝██║ ╚═╝ ██║██║  ██║██║  ██║██████╔╝███████╗
   ╚═════╝ ╚═════╝ ╚═╝     ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝╚═════╝ ╚══════╝
=====================================================================================
   Cyber Operations Module for Resilient Authentication, Defense and Encryption
   comrade-V1.20 | DESIGNED BY MOHAMMED REHAN { Github_id :- zfln-rehan0520 }
=====================================================================================

COMRADE is a high-security, local-first cyber-operations platform engineered for developers, security researchers, and privacy advocates. By leveraging AES-256-GCM authenticated encryption, zero-knowledge credential storage, offline AI intelligence, and a sidecar IRC relay daemon, COMRADE ensures your sensitive assets and communications remain mathematically inaccessible to unauthorized entities.

---

🛠️ Core Features

• Zero-Knowledge Vault Architecture: Encryption and decryption occur strictly in memory via AES-256-GCM and Scrypt KDF. Master keys reside solely in volatile RAM and are never written to disk.
• Kernel Stealth (Ghost Mode): On Windows, utilizes SetFileAttributesW to flag the stealth vault as a System Protected component invisible even if "Show Hidden Files" is enabled.
• Anti-Forensic Wiping: Implements a secure-erase protocol where source assets are overwritten in-place with high-entropy cryptographic random bytes (secrets.token_bytes) before physical deletion.
• Offline AI Intelligence Assistant: Driven locally via Ollama (qwen2.5:1.5b), enabling private context reasoning, code audits, and operational assistance without sending telemetry out of network boundaries.
• Stealth Sidecar IRC Relay: Built-in end-to-end encrypted chat interface connecting locally to an Ergo IRC daemon (127.0.0.1:6667) for private channel communications.
• Zero-Knowledge Password Manager: Encrypted local credential database featuring high-entropy 20-bit password generation, encrypted JSON backups, and self-destructing 10-second clipboard memory.
• Operational Integrity & Process Locks: Employs cross-platform file locks (fcntl on Linux/macOS, handles on Windows) to prevent concurrent instances from corrupting vault manifests.

---

📁 Project Structure

COMRADE/
├── ai/                         # Offline Neural Inference Engine (Ollama API Adapter)
├── bin/                        # Binary Executables & Auxiliary Helpers
├── cli/                        # Terminal Interface Layer & Custom ASCII Banners
├── comrade.egg-info/           # Python Package Metadata & Distribution Info
├── core/                       # Cryptographic Engine (AES-256-GCM, Scrypt KDF, Credentials)
├── network/                    # Stealth Networking Protocols & Transport Layer
├── test/                       # Verification Suite (Auth, Cryptography & System Tests)
├── ui/                         # Graphical Dashboard Layer (CustomTkinter GUI)
├── .comrade_credentials.enc    # Encrypted Credential Vault Payload
├── .comrade_credentials.json   # Local Credential Storage Manifest
├── .gitignore                  # Multi-Platform Git Exclusion Rules
├── LICENSE                     # Project License Terms
├── audit.py                    # Pre-flight Diagnostic & System Health Suite
├── main.py                     # System Entry Point, CLI Router & Dispatcher
├── requirements.txt            # Global Python Dependencies
├── setup.ps1                   # Automated Setup Script (Windows PowerShell)
├── setup.py                    # Package Build & Installation Script
└── setup.sh                    # Automated Setup Script (Linux / macOS Shell)

---

🌍 Multi-Platform Deployment & Usage

COMRADE is engineered to adapt its security layer based on the host Operating System.

🛠️ COMRADE :: Operational Command Cheat Sheet

clone the Repo :

git clone https://github.com/zfln-rehan0520/COMRADE.git

---

🚀 Environment Activation Commands

Windows (PowerShell)

cd COMRADE
py -m venv venv
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process
.\venv\Scripts\Activate.ps1
.\setup.ps1

Linux (Terminal)

cd COMRADE
chmod +x setup.sh && ./setup.sh
source venv/bin/activate

---

Windows GUI & CLI cmd

GUI

.\comrade gui

---

CLI

Direct Vault Management

# ===  List All Encrypted Assets in Vault ===
.\comrade cli

# ===  Secure File & Shred Source ===
.\comrade secure

# ===  Extract & Decrypt Asset ===
.\comrade extract <id>

# ===  Anti-Forensic Wipe / Permanent Purge ===
.\comrade remove <id>

---

Interactive Subsystems

# ===  Offline Local AI Assistant ===
.\comrade run ai

# ===  Terminal Password / Credential Manager ===
.\comrade run securepass

# ===  Stealth IRC Chat Client ===
.\comrade run chat

---

Diagnostics & Background Services

# ===  Run Automated Diagnostic & Audit Suite ===
.\comrade audit.py

# ===  Start Stealth IRC Relay Server (Ergo Daemon) ===
cd bin\ergo-2.19.0-windows-x86_64
.\ergo.exe run

# ===  Download Local AI Neural Weights (Ollama) ===
ollama pull qwen2.5:1.5b

---

Linux GUI & CLI cmd

GUI

.\comrade gui

---

Interactive Subsystems

# === List All Encrypted Assets in Vault ===
.\comrade cli
# === Offline Local AI Assistant ===
.\comrade run ai

# === Terminal Password / Credential Manager ===
.\comrade run securepass

# === Stealth IRC Chat Client ===
.\comrade run chat

---

Direct Vault Management

# ===  Secure File & Shred Source ===
.\comrade secure "file_path"

# ===  Extract & Decrypt Asset ===
.\comrade extract <id>

# ===  Anti-Forensic Wipe / Permanent Purge ===
.\comrade remove <id>

---

Diagnostics & Background Services

# ===  Run Automated Diagnostic & Audit Suite ===
.\comrade audit.py

# ===  Start Stealth IRC Relay Server (Ergo Daemon) ===
cd bin/ergo-2.19.0-linux-x86_64
./ergo run

# === Download Local AI Neural Weights (Ollama) ===
ollama pull qwen2.5:1.5b

---

👤 Author

Mohammed Rehan

Disclaimer: This tool is intended for professional security operations and educational purposes only. Use responsibly!