New README + Demonstartional video
This commit is contained in:
parent
95f8a192b5
commit
e3a3dd3f0f
124
README.MD
124
README.MD
|
|
@ -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.
|
||||
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.python.org/downloads/)
|
||||
[](#)
|
||||
|
||||
</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)
|
||||
|
||||
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.
|
||||
|
||||

|
||||
|
||||
<div align="center">
|
||||
|
||||
Built for the shadows.
|
||||
|
||||
If this repo disappears, you know why. 😉
|
||||
|
||||
⭐ Star it while it's still up
|
||||
|
||||
</div>
|
||||
|
|
|
|||
BIN
example.gif
BIN
example.gif
Binary file not shown.
|
Before Width: | Height: | Size: 235 KiB After Width: | Height: | Size: 2.7 MiB |
Loading…
Reference in New Issue
Block a user