DeProtocol

A Decentralized and Highly Encrypted P2P Chat over Tor
Join the Discord »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

DeProtcol is a decentralized and highly secure peer-to-peer protocol that provides end-to-end encryption and anonymity for its users. It uses Tor as the underlying network layer to ensure that all communications are routed through multiple relays, making it virtually impossible for anyone to trace the communication back to their origin.

DeChat is designed to be highly resilient and resistant to censorship. Since the application is decentralized, there is no central point of control or failure, making it virtually impossible for any entity to shut down the network or censor individual users.

Here's why:

• Decentralized Peer-to-Peer protocol (no server endings)
• Highly secure with end-to-end encryption
• Anonymized communication relayed in Tor Network
• Highly resilient and resistant to censorship
• File sharing (Soon)

(back to top)

Built With

• 
• 

(back to top)

Getting Started

To get a local copy up and running follow these simple example steps.

Prerequisites

Install Python 3.10: You can download and install Python 3.10 from the official Python website (https://www.python.org/downloads/).

1. Verify python installation:

python --version

2. Create a virtual environment (recommended):

python -m venv myenv

3. Activate your environment:

Linux/MacOS: source myenv/bin/activate

Windows: myenv\Scripts\activate.bat

Installation

1. Clone the repo

   git clone https://github.com/werogg/deprotocol.git

2. Install requirements

   pip install -r requirements.txt

Execute

1. Run the application

   python src/deprotocol/app/main.py

Build

1. Install additional build requirement

   pip install build

2. Build the wheel root folder

   python -m build . --wheel

Run unit tests

1. Install additional pytest requirement

   pip install pytest

2. Run the tests

   pytest

Run behaviour tests (not ready)

1. Install additional behave requirement

   pip install behave

2. Run the tests

   not ready

(back to top)

Usage

Basically when the protocol app is ready it will be prompted in the console, you have a help command to guide you. My recommendations to test the usage is using address command to get the onion address, the connect command to connect to an address and finally the msg command to test the encrypted byte transmission.

(back to top)

Roadmap

• Add P2P Protocol
• Add Relay on Tor Network
• Add Custom Communication Protocol (in progress)
• Add 90% testing for continuous integration
• Add Protocol API for external uses as lib (in progress)
• Improve encryption algorithms (in progress)

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

Please join our Discord Server if you would like to contribute, it will be great for me to have a community support to chat about it.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License with Aditional Conditions. See LICENSE for more information.

(back to top)

Contact

Joel Otero - @werogg1 - [email protected]

Project Link: https://github.com/werogg/deprotocol

(back to top)

Acknowledgments

Resources and credits!

• Python
• Tor Project
• University of Barcelona

(back to top)