robin_net:start
This is an old revision of the document!
Table of Contents
RobinNet
RobinNet is a lightweight store-and-forward messaging network designed for:
- Local LAN nodes
- Mesh networking
- Low-bandwidth packet radio links
- Emergency communications
- Preparedness infrastructure
The system allows independent nodes to exchange messages and bulletins through a simple synchronization protocol.
Each node stores messages locally and forwards them to peers.
Design Philosophy
RobinNet was designed with the following principles:
- Low bandwidth friendly
- Offline capable
- Store-and-forward messaging
- Simple architecture
- Runs on small hardware
- Easy to audit
Nodes can run on:
- Raspberry Pi
- Linux servers
- Small home lab machines
- emergency field systems
Core Components
| File | Purpose |
|---|---|
| db.py | SQLite database layer |
| models.py | Message structures and hashing |
| cli.py | Command line interface |
| api.py | HTTP API server |
| sync.py | Peer synchronization engine |
| main.py | Node launcher |
| daemon.py | Background worker |
Architecture Overview
RobinNet nodes communicate using a lightweight HTTP API.
Flow example:
- Node A creates a bulletin
- Node A stores it locally
- Node B requests summaries
- Node B fetches missing messages
- Node B stores them locally
This allows asynchronous propagation across the network.
Documentation
| Section | Description |
|---|---|
| install | Installing and deploying RobinNet |
| testing | Testing workflows |
| api | Full API documentation |
Source Modules
Future Components
Planned additions:
- Cardinal UI (PyQt6)
- RF transport
- message moderation
- node discovery
- mesh support
- optional encryption
robin_net/start.1773242440.txt.gz · Last modified: by freedomotter