New README + Demonstartional video

This commit is contained in:
mirai 2026-01-02 20:37:11 +03:00
parent 95f8a192b5
commit e3a3dd3f0f
2 changed files with 79 additions and 45 deletions

124
README.MD
View File

@ -1,64 +1,98 @@
# CMD CHAT
<div align="center">
**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)](#)
</div>
---
## 🔒 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)
Heres 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)
<div align="center">
Built for the shadows.
If this repo disappears, you know why. 😉
⭐ Star it while it's still up
</div>

Binary file not shown.

Before

Width:  |  Height:  |  Size: 235 KiB

After

Width:  |  Height:  |  Size: 2.7 MiB