SmartHomeOS

A unified smart-home brain that runs locally, combining the functionality of Homebridge + Scrypted with AI video enhancement and multi-ecosystem output support.

Features

• Single Source of Truth: Devices exist once internally; HomeKit/Alexa/Google are outputs
• Capability-Based Architecture: Ecosystem-agnostic device capabilities
• First-Class Camera Support: 4K ingest, AI upscaling, multi-resolution outputs
• Local-First: All processing runs locally on your hardware
• Plugin System: Native plugins + Homebridge/Home Assistant compatibility
• Multi-Ecosystem: Expose devices to Apple HomeKit, Amazon Alexa, Google Home

Architecture

┌─────────────────────────────────────────────────────────────────┐
│                        SmartHomeOS Core                          │
├─────────────────────────────────────────────────────────────────┤
│  Device Registry │ Capability System │ Event Bus │ State Mgr    │
├─────────────────────────────────────────────────────────────────┤
│                     Device Deduplication                         │
├──────────────┬──────────────┬────────────────────────────────────┤
│ Native       │ Homebridge   │ Home Assistant                     │
│ Plugins      │ Compat Layer │ Integration Runner                 │
├──────────────┴──────────────┴────────────────────────────────────┤
│                        Video Pipeline                            │
│     NVDEC/QSV Decode → Ring Buffer → NVENC/QSV Encode           │
├─────────────────────────────────────────────────────────────────┤
│                     AI Enhancement Layer                         │
│        ESRGAN Upscaling │ Denoising │ Object Detection          │
├─────────────────────────────────────────────────────────────────┤
│                      Output Adapters                             │
│         HomeKit (HAP) │ Alexa │ Google Home                     │
└─────────────────────────────────────────────────────────────────┘

Requirements

• Node.js 18+
• NVIDIA GPU with CUDA (RTX 3060 recommended)
• Intel CPU with Quick Sync (optional fallback)
• FFmpeg with NVENC/NVDEC support
• Python 3.10+ (for AI service)

Quick Start

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build
npm start

Project Structure

SmartHomeOS/
├── src/
│   ├── core/                    # Core services
│   ├── video/                   # Video pipeline
│   ├── ai/                      # AI enhancement client
│   ├── plugins/                 # Native device plugins
│   ├── homebridge-compat/       # Homebridge compatibility
│   ├── home-assistant/          # HA integration runner
│   ├── dedup/                   # Device deduplication
│   ├── adapters/                # Ecosystem adapters
│   ├── network/                 # Network diagnostics
│   └── api/                     # REST API
├── web/                         # React dashboard
├── ai-service/                  # Python AI microservice
├── config/                      # Configuration
└── docs/                        # Documentation

Plugins

Native plugins are simple device drivers that discover devices and update state. They do NOT define HomeKit services or handle ecosystem exposure.

Plugin	Devices
Eufy	Doorbells, Cameras
Tuya/Smart Life	Bulbs, Switches
Meross	Garage Doors
Alarm.com	Security Panel
Fire TV	Media Players
Nest	Thermostats

Homebridge Compatibility

Load existing Homebridge plugins! The compatibility layer:

• Emulates Homebridge API (registerAccessory, registerPlatform)
• Converts HAP services to internal capabilities
• Does NOT expose directly to HomeKit (controlled by adapters)

npm install homebridge-plugin-name

Home Assistant Integration

Use HA integrations as device drivers without running full HA:

• Headless HA Core runtime
• State synchronization via WebSocket
• Entity-to-device mapping

License

MIT