Remote Valley OS

A system-of-systems integration layer connecting hardware, data, and people into one coherent infrastructure. Open source. Offline-first. Field-tested.

View on GitHub Explore the Modules

What RV-OS Is

Remote Valley OS is not an operating system in the Windows/Linux sense. It is a system-of-systems integration layer — the middleware and tooling that connects five independent infrastructure modules into a unified, observable, and manageable whole.

Each module works on its own. RV-OS makes them work together. The stack runs fully offline and syncs to GitHub when connectivity is available.

Dashboard & Alerts Web UI + SMS + LoRa text messages

↓

RV-OS Core API FastAPI / lightweight, offline-capable

↓

Sensor Ingestion MQTT + LoRa + serial bridges

Local LLM Offline AI assistant (Nepali + English)

GitHub Sync Async, when connected

↓

Module Data Sources Waste · Water · Energy · Food · EV · Mesh

Sensor Ingestion Pipeline

Every module is instrumented with sensors that report operational data. A lightweight agent on each module cluster collects, timestamps, and stores data locally before relaying it over LoRa or MQTT to the central collector.

Extruder temp Serial / 5 sec / ~50B

Water turbidity / pH Modbus / 15 min / ~120B

Solar voltage / current Modbus / 10 sec / ~60B

Hydro turbine RPM GPIO / 1 sec / ~16B

Battery SoC / temp CAN bus / 30 sec / ~80B

Cold storage temp I2C / 5 min / ~32B

EV charger status MQTT/LoRa / event / ~100B

Mesh node uptime LoRaWAN / 1 hr / ~24B

Each module cluster has a local Raspberry Pi (or equivalent) running a lightweight agent. Agents communicate over LoRa when no Wi-Fi or satellite link is available.

Local LLM

A small, locally-hosted language model runs on the hub server, powered by the micro-grid. It answers maintenance questions in Nepali and English, walks operators through troubleshooting, and translates documentation — all fully offline.

Model: Quantized 7B (4-bit, ~4GB RAM)

Hardware: Jetson Nano or equivalent (~15W)

Capabilities: Troubleshooting, translation, education, field logging

Updates: New weights delivered via USB or satellite sync

Offline-First Design

Every component runs fully offline. Internet is never required for operation.

Sensor ingestionStream normalBuffer locally indefinitely

DashboardReal-time dataCached data, update on reconnect

Local LLMNo changeNo change (always local)

GitHub syncPush metrics, pull updatesQueue for next connection

AlertingSMS + dashboardLoRa + dashboard

OTA updatesPull from GitHubUSB stick update

Hardware Requirements

Central serverRaspberry Pi 4 (4GB)~15W$75

Sensor agent (per module)Pi Zero 2 W~3W$25

Local LLM nodeJetson Nano~15W$250

LoRa gatewayDragino LG-01~2W$100

Local storage64GB SD + 256GB SSD~2W$40

NetworkingWi-Fi + LoRaWAN~10W$80

Total per village~47W~$570

Security Model

All data encrypted at rest

Sensor data locally owned — never transmitted without explicit sync

GitHub sync sends aggregated metrics only unless configured otherwise

Physical access required to compromise sensor agents — no remote exploit path

Dashboard access controlled by local network + simple password (offline context)

Software Stack

API server FastAPI (Python)

Dashboard Astro + SolidJS (static)

Database SQLite (local), PostgreSQL (analytics)

Sensor protocol MQTT over LoRa, Modbus RTU, CAN bus

LLM inference llama.cpp (quantized 4-bit)

Sync rsync over SSH (satellite)

Containerization Docker Compose

CI/CD GitHub Actions

Deployment Phases

Phase 1

Single Village

One RV-OS instance serving all modules in one village. Setup: 2 days. Operator training: 1 week. Data stored locally, syncs when connected.

Phase 2

Valley-Wide

Multiple village instances connected via LoRa mesh backbone. Central dashboard at the hub village. Range: up to 50km corridor. Cross-village alerts.

Phase 3

Multi-Region

Independent deployments in different regions, each adapted to local conditions. Anonymous metrics feed back to the global project.

Repositories

rv-os-core

API server, dashboard frontend, database schema

rv-os-agent

Per-module sensor agent firmware and scripts

rv-os-local-llm

Model quantization, prompt templates, deployment scripts

rv-os-sync

GitHub synchronization tooling

rv-os-manifest

Compatibility matrix of module versions

rv-os-docs

Central documentation, architecture, deployment guide

Start Building

Star the repo, open an issue, submit a PR, or apply for the Jumla residency. Every contribution moves the mission forward.

GitHub Apply for Residency Deploy in Your Region