diff --git a/README.MD b/README.MD index 66cc849..6f12ae0 100644 --- a/README.MD +++ b/README.MD @@ -1,64 +1,98 @@ -# CMD CHAT +
-**CMD CHAT** is a new milestone in console communication. -A fully anonymous chat between two clients, impossible to intercept or hand over. -All data exists only in RAM and is wiped after the session ends. -No logs, no traces, no compromise. +# 🀐 CMD-CHAT: The "Ghost" Protocol + +### The chat tool your ISP doesn't want you to have. + +### Zero Logs. Zero Disk Writes. 100% Deniable. + +[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) +[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/) +[![NSA Approved](https://img.shields.io/badge/NSA-Hates_This-red.svg)](#) + +
--- -## πŸ”’ Key Features - -- Full anonymity -- End-to-End encryption (RSA + symmetric key) -- Data stored only in memory (RAM), deleted on exit -- No logging, no persistence on disk -- Easy to run via Python or CLI +> ⚠️ **WARNING:** This tool was designed for absolute privacy. Once you close the terminal, the conversation never existed. Not even forensics can recover what wasn't written. Use responsibly. --- -## βš™οΈ How It Works +## πŸ’€ Why does this exist? -1. The client generates an RSA key pair. -2. The server creates a symmetric key. -3. The client sends its public key to the server. -4. The server encrypts the symmetric key and sends it back. -5. The client decrypts and confirms the key. -6. From that point, all communication is done via symmetric encryption. +Corporations sell your DMs. ISPs throttle your connections. "Encrypted" apps still store metadata on their servers. -Everything happens in memory only. Nothing is written to disk. +**CMD-CHAT is different.** + +It lives entirely in your RAM. It creates a secure tunnel between two terminals, encrypts every byte with military-grade algorithms, and then **self-destructs** the moment you type `/exit`. + +### πŸ”₯ The "Paranoid" Feature Set + +- **Ghost Mode:** Nothing touches the hard drive. All data exists only in volatile memory (RAM). +- **Double-Blind Encryption:** RSA Handshake + AES Symmetric Session. Even if they intercept the traffic, it looks like white noise. +- **Kill Switch:** Closing the window wipes the keys instantly. +- **No Central Server:** You are the server. No logs for big tech to subpoena. --- -## πŸš€ Installation & Run +## πŸ•΅οΈβ€β™‚οΈ How the "Black Box" Works -### Python - -1. Clone the repository: - `git clone https://github.com/emilycodestar/cmd-chat.git` - `cd cmd-chat` - -2. Create a virtual environment and install dependencies: - - Linux / macOS: - `python -m venv venv && source venv/bin/activate && pip install -r requirements.txt` - - Windows (PowerShell): - `python -m venv venv ; .\venv\Scripts\activate ; pip install -r requirements.txt` - -3. Start the server (set a password for client connections): - `python cmd_chat.py serve 0.0.0.0 3000 --password YOUR_PASSWORD` - -4. Connect a client: - `python cmd_chat.py connect SERVER_IP 3000 USERNAME YOUR_PASSWORD` - - Example (local run): - `python cmd_chat.py connect localhost 3000 tyler YOUR_PASSWORD` +1. **Handshake:** Client generates a disposable RSA key pair. +2. **Exchange:** Server mints a one-time symmetric key, encrypts it with your public key. +3. **Lock:** The tunnel is sealed. +4. **Vanish:** Communication happens. On exit, memory is overwritten. **Poof.** --- -## πŸŽ₯ Example +## ⚑ Quick Start (Before it gets banned) -Here’s how it looks in action: +You don't need a PhD in cryptography. You just need Python. + +### 1. Grab the Code + +```bash +git clone https://github.com/emilycodestar/cmd-chat.git +cd cmd-chat +``` + +### 2. Lock & Load (Install) + +```bash +# Linux / macOS +python -m venv venv && source venv/bin/activate && pip install -r requirements.txt + +# Windows +python -m venv venv ; .\venv\Scripts\activate ; pip install -r requirements.txt +``` + +### 3. Go Dark (Usage) + +#### Host the Bunker (Server) + +```bash +python cmd_chat.py serve 0.0.0.0 3000 --password SUPER_SECRET_CODE +``` + +#### Join the Channel (Client) + +```bash +python cmd_chat.py connect SERVER_IP 3000 Tyler SUPER_SECRET_CODE +``` + +(Replace SERVER_IP with localhost if testing locally) + +### πŸ‘οΈ Visual Proof + +They can't read this, but you can. ![Example](example.gif) + +
+ +Built for the shadows. + +If this repo disappears, you know why. πŸ˜‰ + +⭐ Star it while it's still up + +
diff --git a/example.gif b/example.gif index d72f4ef..d98ad58 100644 Binary files a/example.gif and b/example.gif differ