Update README.md
co-authored-by: assistant
This commit is contained in:
assistant
@@ -1,56 +1,96 @@
|
|||||||
# Multipurpose Radio Server (MRS)
|
<!-- Header -->
|
||||||
|
<div id="top" align="center">
|
||||||
|
<br />
|
||||||
|
|
||||||
---
|
<!-- Logo -->
|
||||||
|
<img src="https://meshtastic.org/assets/images/lora-topology-2-c80684f1eafdf2a71fbaf26e494fb26d.webp" alt="Logo" width="200" height="200">
|
||||||
|
|
||||||
###### By: Zakary Timson
|
<!-- Title -->
|
||||||
###### Date: September 2026
|
### Multipurpose Radio Server (MRS)
|
||||||
###### Version: 1.0
|
|
||||||
|
|
||||||
---
|
<!-- Description -->
|
||||||
|
A comprehensive, offline-first communication and intelligence platform built for service-denied environments.
|
||||||
|
|
||||||
> Compact communication and information exchange server for service-denied areas. Ideal for disaster response, long-range tracking, and offline-first operations.
|
<!-- Repo badges (Using generic placeholders as dynamic data is unavailable) -->
|
||||||
|
[](https://git.zakscode.com/ztimson/mrs/tags)
|
||||||
|
[](https://git.zakscode.com/ztimson/mrs/pull)
|
||||||
|
[](https://git.zakscode.com/ztimson/mrs/issues)
|
||||||
|
|
||||||
---
|
<!-- Links -->
|
||||||
|
---
|
||||||
|
<div align="center">
|
||||||
|
<a href="https://git.zakscode.com/ztimson/mrs/wiki" target="_blank">Documentation</a>
|
||||||
|
• <a href="https://git.zakscode.com/ztimson/mrs/releases" target="_blank">Release Notes</a>
|
||||||
|
• <a href="https://git.zakscode.com/ztimson/mrs/issues/new?template=.github/issue_template/bug.md" target="_blank">Report a Bug</a>
|
||||||
|
• <a href="https://git.zakscode.com/ztimson/mrs/issues/new?template=.github/issue_template/enhancement.md" target="_blank">Request a Feature</a>
|
||||||
|
</div >
|
||||||
|
|
||||||
## 🗂️ Capabilities
|
---
|
||||||
|
</div >
|
||||||
|
|
||||||
**Networking:**
|
## Table of Contents
|
||||||
* 900 MHz HaLow / 2.4/5 GHz Mesh WiFi (B.A.T.M.A.N.)
|
- [About](#top)
|
||||||
* LoRa radio communication (Meshtastic node)
|
- [Description](#description)
|
||||||
* Captive portal & device home page setup
|
- [Inspiration](#inspiration)
|
||||||
|
- [Capabilities](#capabilities)
|
||||||
|
- [Manual](#manual)
|
||||||
|
- [Setup](#setup)
|
||||||
|
- [Production](#production)
|
||||||
|
- [Development](#development)
|
||||||
|
- [License](#license)
|
||||||
|
|
||||||
**Communication:**
|
## About
|
||||||
* Offline federated chat (Synapse/Element)
|
|
||||||
* GPS positioning & offline maps
|
|
||||||
|
|
||||||
**Tools & Integration:**
|
### Description
|
||||||
* **AI Assistant**: Powered by the custom **AI-Harness** (Gemma4-e2b)
|
MRS is a hardware-focused radio server that acts as the core of the system, providing the physical connectivity and reconnaissance capabilities. It is unified by the OpenCast media/control layer and the AI-Harness intelligence layer.
|
||||||
* **Knowledge Base**: Offline access via **Kiwix** (Harness provided)
|
|
||||||
* **Reconnaissance**: Bettercap, nmap, aircrack, Metasploit, and SDRAngel
|
|
||||||
* **Media/Control**: Control and casting interface provided by **OpenCast**
|
|
||||||
* **Remote Access**: VNC built into the **OpenCast** layer
|
|
||||||
|
|
||||||
---
|
### Inspiration
|
||||||
|
This project was built for resiliency and offline capability, drawing from:
|
||||||
|
- [A.C.I.D](https://www.youtube.com/watch?v=nSrYmkGq9TM)
|
||||||
|
- [Offline internet](https://www.youtube.com/watch?v=L5RJZmuRJKA)
|
||||||
|
- [Meshtastic radios](https://morosx.com/ols/products/xtak-lora-mesh)
|
||||||
|
- [HaLow mesh network](https://www.youtube.com/watch?v=ofR7GFNZzJY)
|
||||||
|
- [Signal Intelligence](https://www.youtube.com/watch?v=Nam87B2u6bo&t=1942s)
|
||||||
|
|
||||||
## 🛠️ Technical Focus
|
### Capabilities
|
||||||
|
|
||||||
MRS acts as the hardware and recon core. All features are unified through the OpenCast control panel and the AI-Harness layer.
|
**Networking**
|
||||||
|
* **Mesh:** 900 MHz HaLow / 2.4/5 GHz Mesh WiFi (B.A.T.M.A.N.)
|
||||||
|
* **Radio:** LoRa radio (Meshtastic node).
|
||||||
|
* **Connectivity:** Captive portal & device home page setup via OpenCast.
|
||||||
|
|
||||||
## 🚀 Quick Start
|
**Communication & Data**
|
||||||
|
* **Chat:** Offline federated chat (Synapse/Element)
|
||||||
|
* **Archive:** Offline knowledge base (Kiwix) and file hosting (AI-Harness).
|
||||||
|
* **Tracking:** GPS positioning & offline maps using gpsd, chrony.
|
||||||
|
|
||||||
```bash
|
**Recon & Security**
|
||||||
# Clone and install
|
* **Tools:** Bettercap, nmap, aircrack, Metasploit, and SDRAngel for hardware and RF recon.
|
||||||
git clone https://git.zakscode.com/ztimson/mrs
|
* **Media:** Control and casting interface provided by OpenCast.
|
||||||
cd mrs
|
|
||||||
|
|
||||||
# Install base dependencies
|
## Manual
|
||||||
npm ci
|
|
||||||
|
|
||||||
# Start core services
|
### Setup
|
||||||
```
|
**Production**
|
||||||
|
1. Run the core MRS services to establish the hardware/radio backbone.
|
||||||
|
2. OpenCast (port 3000) and AI-Harness (port 3001) are required to provide the media control and intelligence interface.
|
||||||
|
|
||||||
---
|
**Development**
|
||||||
|
1. Install dependencies: `npm install`
|
||||||
|
2. Start core services: `npm run dev`
|
||||||
|
|
||||||
## 📜 License
|
## Built With
|
||||||
|
|
||||||
This project is licensed under the MIT License.
|
<p>
|
||||||
|
<!-- List key technologies here -->
|
||||||
|
</p>
|
||||||
|
[](https://www.electronjs.org/)
|
||||||
|
[](https://nodejs.org/)
|
||||||
|
[](https://typescriptlang.org/)
|
||||||
|
[](https://www.nginx.com/)
|
||||||
|
[](https://github.com/ztimson/ai-harness)
|
||||||
|
|
||||||
|
## License
|
||||||
|
Copyright © 2023 Zakary Timson | All Rights Reserved | Available under MIT Licensing
|
||||||
|
|
||||||
|
See the [license](./LICENSE) for more information.
|
||||||
Reference in New Issue
Block a user