NomadNet/README.md

66 lines
3.8 KiB
Markdown
Raw Normal View History

2021-09-18 09:14:54 -04:00
Nomad Network - Communicate Freely
2021-03-27 05:58:13 -04:00
==========
2021-10-08 12:41:20 -04:00
Off-grid, resilient mesh communication with strong encryption, forward secrecy and extreme privacy.
2021-07-13 16:44:10 -04:00
![Screenshot](https://github.com/markqvist/NomadNet/raw/master/docs/screenshots/1.png)
2021-05-17 13:49:12 -04:00
2021-10-08 12:41:20 -04:00
Nomad Network Allows you to build private and resilient communications platforms that are in complete control and ownership of the people that use them. No signups, no agreements, no handover of any data, no permissions and gatekeepers.
2021-07-06 11:37:48 -04:00
2021-10-08 12:41:20 -04:00
Nomad Network is build on [LXMF](https://github.com/markqvist/LXMF) and [Reticulum](https://github.com/markqvist/Reticulum), which together provides the cryptographic mesh functionality and peer-to-peer message routing that Nomad Network relies on. This foundation also makes it possible to use the program over a very wide variety of communication mediums, from packet radio to fiber optics.
2021-07-06 11:37:48 -04:00
2021-10-08 12:41:20 -04:00
Nomad Network does not need any connections to the public internet to work. In fact, it doesn't even need an IP or Ethernet network. You can use it entirely over packet radio, LoRa or even serial lines. But if you wish, you can bridge islanded networks over the Internet or private ethernet networks, or you can build networks running completely over the Internet. The choice is yours.
2021-03-27 05:58:13 -04:00
## Notable Features
2021-05-17 13:58:17 -04:00
- Encrypted messaging over packet-radio, LoRa, WiFi or anything else [Reticulum](https://github.com/markqvist/Reticulum) supports.
- Zero-configuration, minimal-infrastructure mesh communication
2021-10-08 12:41:20 -04:00
- Distributed and encrypted message store holds messages for offline users
2021-09-11 05:11:23 -04:00
- Connectable nodes that can host pages and files
- Node-side generated pages with PHP, Python, bash or others
2021-09-11 05:11:23 -04:00
- Built-in text-based browser for interacting with contents on nodes
- An easy to use and bandwidth efficient markup language for writing pages
- Page caching in browser
2021-05-17 13:58:17 -04:00
## Current Status
2021-09-11 05:11:23 -04:00
The current version of the program should be considered a beta release. The program works well, but there will most probably be bugs and possibly sub-optimal performance in some scenarios. On the other hand, this is the ideal time to have an influence on the direction of the development of Nomad Network. To do so, join the discussion, report bugs and request features here on the GitHub project.
2021-05-17 13:58:17 -04:00
2021-09-11 05:11:23 -04:00
### Feature roadmap
- Access control and authentication for nodes, pages and files
2021-10-08 12:41:20 -04:00
- Network-wide propagated bulletins and discussion threads
- Geospatial information sharing and collaborative maps
2021-03-27 05:58:13 -04:00
## Dependencies:
- Python 3
- RNS
- LXMF
## How do I get started?
The easiest way to install Nomad Network is via pip:
```bash
# Install Nomad Network and dependencies
pip3 install nomadnet
# Run the client
nomadnet
```
The first time the program is running, you will be presented with the guide section, which contains all the information you need to start using Nomad Network.
2021-10-08 12:41:20 -04:00
To use Nomad Network on packet radio or LoRa, you will need to configure your Reticulum installation to use any relevant packet radio TNCs or LoRa devices on your system. See the [Reticulum documentation](https://markqvist.github.io/Reticulum/manual/interfaces.html) for info.
2021-05-17 13:58:17 -04:00
2021-03-27 05:58:13 -04:00
## Caveat Emptor
2021-09-18 09:11:40 -04:00
Nomad Network is beta software, and should be considered as such. While it has been built with cryptography best-practices very foremost in mind, it _has not_ been externally security audited, and there could very well be privacy-breaking bugs. If you want to help out, or help sponsor an audit, please do get in touch.
## Screenshots
![Screenshot 1](https://github.com/markqvist/NomadNet/raw/master/docs/screenshots/1.png)
![Screenshot 2](https://github.com/markqvist/NomadNet/raw/master/docs/screenshots/2.png)
![Screenshot 3](https://github.com/markqvist/NomadNet/raw/master/docs/screenshots/3.png)
![Screenshot 4](https://github.com/markqvist/NomadNet/raw/master/docs/screenshots/4.png)
2021-09-18 09:14:54 -04:00
![Screenshot 5](https://github.com/markqvist/NomadNet/raw/master/docs/screenshots/5.png)