NestShift OS

A local-first, edge AI operating system for the home. Learns your patterns. Runs entirely offline. No cloud, no subscriptions, no surveillance.

License: MIT Python 3.10+ Node 18+

NestShift OS turns a Raspberry Pi into a truly autonomous home brain. Unlike smart home hubs that rely on rigid "if-this-then-that" rules, NestShift uses a neural core that learns from your behavior and anticipates what you need — all without sending a single byte to the cloud.

It runs every AI model locally: voice recognition, energy forecasting, behavioral learning, and safety filtering. Your data stays in your house. Period.

git clone https://github.com/aryan597/nestshift-os.git
cd nestshift-os/dashboard
npm install
npm run dev
# Open http://localhost:5173

cd services/brain
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt
python main.py

curl -sSL https://raw.githubusercontent.com/aryan597/nestshift-os/main/scripts/install.sh | bash

Note: Full stack deployment requires Mosquitto MQTT, InfluxDB, and Zigbee2MQTT. See ARCHITECTURE.md for detailed service topology.

┌─────────────────┐ ┌──────────────┐ ┌─────────────────┐
│ OrbitAI Dashboard │◄────►│ FastAPI │◄────►│ Mosquitto MQTT │
│ (React + Vite) │ │ Gateway │ │ (TLS) │
└─────────────────┘ └──────────────┘ └─────────────────┘
 │
 ┌──────────────┬──────────────┬─────────────────┼─────────────────┐
 ▼ ▼ ▼ ▼ ▼
┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐
│ Brain │ │ Energy │ │ Automation │ │ System │ │ Zigbee │
│ (NARE) │ │ Agent │ │ Agent │ │ Agent │ │ / GPIO │
└────────────┘ └────────────┘ └────────────┘ └────────────┘ └────────────┘

• NARE Brain — LIF spiking neurons + STDP learning
• Energy Agent — LightGBM demand forecasting + Octopus Agile tariff arbitrage
• Automation Agent — Hourly behavior pattern mining with confidence scoring
• System Agent — Drift detection, model freshness, hardware health
• Pi-safe — Immutable safety filter between all agents and physical hardware

Read the full architecture: ARCHITECTURE.md

nestshift-os/
├── dashboard/ # React + Vite OrbitAI UI
├── services/ # Microservices (FastAPI + asyncio)
│ ├── api/ # REST gateway & auth
│ ├── brain/ # NARE neural core
│ ├── energy-agent/ # Demand forecasting & tariff logic
│ ├── automation-agent/ # Behavioral pattern learning
│ ├── system-agent/ # Drift detection & monitoring
│ ├── gpio/ # Raspberry Pi hardware interface
│ └── zigbee/ # Zigbee2MQTT bridge
├── board/ # Buildroot OS overlay
├── config/ # Hardware & neural config
├── scripts/ # Installation & flashing helpers
├── simulation/ # Digital twin evaluation framework
├── tests/ # Safety & logic test suite
└── systemd/ # Production service units

• Local-first: 100% of inference and data stays on your Pi. No cloud APIs, no telemetry, no outbound analytics.
• Encrypted transport: All MQTT traffic uses TLS. JWT auth on REST endpoints.
• Immutable safety: Pi-safe constraints are hardcoded. No prompt injection, voice spoof, or model drift can disable them.
• Camera-free: Optional WiFi CSI sensing (RuView) for through-wall occupancy without cameras or wearables.

NestShift OS is the product of active research in edge AI and residential energy optimisation.

• Energy optimisation: 9–13% cost reduction across dynamic tariffs (see RESEARCH.md)
• Solar self-consumption: 12–38% savings for solar-equipped households
• Digital twin: Reproducible Monte Carlo simulation framework included in simulation/

Read the full research background: RESEARCH.md

NestShift sits at the intersection of neuroscience, embedded systems, and home automation. We're actively looking for contributors in:

• Spiking neural networks (snnTorch / Norse)
• Embedded ML & ONNX Runtime on ARM64
• Zigbee / Matter device integrations
• Safety-critical systems verification

Open an issue or draft PR. All contributions are reviewed through the Pi-safe lens: safety first, features second.

Built by NestShift Ltd for a sustainable, intelligent future.