IX-GhostProtocol is a modular, developer-focused protocol and reference implementation for secure, metadata-resistant, peer-to-peer communication. It is designed to function without centralized infrastructure, storing no identifiable metadata, and offering true forward secrecy, onion routing, and zero-trust connectivity out of the box.
Built for those who demand privacy, resilience, and real-world usability — not someday, but now.
In today’s digital world, most "encrypted" apps still expose:
- IP addresses
- Contact metadata
- Server-based intermediaries
- Identifiable app-level fingerprints
IX-GhostProtocol eliminates those vectors. It enables real-time communication and relay across hostile networks (e.g., firewalls, surveillance zones) while preventing long-term metadata buildup or historical traceability.
This is not a VPN or Tor replacement. It’s a protocol layer for developers building censorship-resistant, privacy-critical, secure communication tooling — from chat apps to sensor relays.
✅ End-to-end encryption (Curve25519 + AES-GCM)
✅ Onion routing with multi-hop relays
✅ Forward secrecy with rotating ephemeral keys
✅ No user accounts, no central servers
✅ Lightweight P2P transport with relay fallback
✅ Pluggable transports (UDP, TCP, domain-fronting, covert channels)
✅ Metadata resistance by default
✅ Optional GUI frontend for non-technical use
| Folder | Purpose |
|---|---|
| /core/ | Main protocol logic and networking stack |
| /relay/ | Stateless relay node service |
| /transport/ | Pluggable transport layers (UDP, TCP, etc) |
| /crypto/ | Encryption, key exchange, session secrets |
| /examples/ | Example apps, bots, test harnesses |
| /gui/ | GUI frontend using Kivy (optional) |
| /docs/ | Technical documentation & protocol specs |
Clone the repository and install dependencies (Python 3.9+ recommended):
git clone https://github.com/YOURUSER/IX-GhostProtocol.git
cd IX-GhostProtocol
pip install -r requirements.txt
Start a secure session between two nodes:
Node A: python core/session.py --listen
Node B: python core/session.py --connect <Node A's address>
(Optional GUI can be launched via gui/main.py)
📦 Usage Scenarios
Secure chat or messaging apps
Peer-to-peer IoT device communication
Decentralized sensor mesh relays
Surveillance-resistant coordination tools
Communication inside censored or air-gapped environments
📚 Documentation
Full protocol documentation and system architecture are available in:
/docs/spec.md
/docs/architecture.md
/docs/deployment-guide.md
🤝 Contributing
We welcome community contributors focused on:
Protocol hardening
GUI and UX improvements
Additional transports (e.g., WebRTC, LoRa)
Third-party language bindings (Rust, Go, C++)
Please see CONTRIBUTING.md before submitting PRs.
🧪 Status
✅ Stable core protocol
🧪 Beta GUI interface
🧪 Relay service under load testing
🛠️ Pluggable transport layer in active development
This project is under continuous development and should not yet be considered production-grade.
🔒 License
IX-GhostProtocol is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).
You are free to use, modify, and distribute this software, but any use in a networked service must also provide source code access to its users. This ensures the project's principles — privacy, transparency, and autonomy — remain protected even in hosted scenarios.
See LICENSE for full terms.
🌍 About the Project
This repo was created to answer a clear gap in secure communications: a modern, peer-to-peer, metadata-resistant protocol that’s usable, modular, and doesn't rely on central services. It's built to be understood, extended, and deployed by developers and privacy-minded engineers across the globe.
IX-GhostProtocol is open-source by necessity, not convenience.
I believe the world doesn’t need another chat app. It needs a foundation for secure communication that won’t disappear when a company folds or a country blocks it.
📫 Questions, ideas, or contributions? Open an issue or start a discussion — let's build it together.