# UpaSmartHome (upaHome)

> Open, privacy-first, local-capable smart home automation system built for Raspberry Pi with Zigbee sensors, multi-channel relays, automated per-room heating/boiler controls, and native Apple HomeKit, Google Home, and Amazon Alexa voice integrations.

## Core Capabilities
- **Local-First Architecture**: Runs locally on Raspberry Pi (4B/5) using Raspberry Pi OS, Zigbee2MQTT, and a high-performance Go backend (smarthomeapi). All pairing, relay automation, multi-zone heating schedules, and Apple HomeKit controls execute 100% locally with zero cloud dependence.
- **Wireless Zigbee Telemetry**: Live environmental monitoring (temperature, humidity, door/window contacts, PIR motion, water leak, and vibration) using SONOFF SNZB-02D, Tuya, Aqara, and thousands of Zigbee2MQTT-supported devices.
- **Smart Multi-Room Heating & Boiler Control**: Independent per-room thermostat setpoints that automatically switch physical boiler pumps, motorized zone valves, or electric heating circuits via relay channels. Heat-only design matching European hydronic and electric heating.
- **Relay Scheduling & Impulse Controls**: Timers, minute-level interval schedules, and low-voltage dry contact triggers for garage doors and multi-channel equipment.
- **Bluetooth Low Energy (BLE) Wi-Fi Provisioning**: Fast headless Raspberry Pi Wi-Fi setup directly from the upaHome mobile app without Ethernet cables, monitors, or keyboards.
- **Multi-Ecosystem Voice Control**:
  - Apple HomeKit: Direct local network pairing with Apple Home app and Siri (no cloud account required).
  - Google Home & Assistant: Account linking via Actions on Google with real-time state sync via Google HomeGraph.
  - Amazon Alexa: Official Alexa Smart Home skill for voice toggles, setpoint adjustments, and sensor checks.

## Products & Editions
- **Complete Hardware Starter Kit (399 EUR)**:
  - 1x Raspberry Pi 4 Model B (with Gigabit LAN)
  - 1x Waveshare 8-channel Industrial Relay HAT
  - 5x SONOFF SNZB-02D Zigbee LCD Temperature & Humidity Sensors
  - 1x Integrated Zigbee USB coordinator gateway
  - 1 Year Free Cloud Subscription included (then 60 EUR/year)
- **Digital Only — DIY Hub Pro Cloud (50 EUR 1st year, then 60 EUR/year)**:
  - 1 Year of Pro Cloud (encrypted remote mobile access + instant push alerts) for a hub you build yourself from the open-source firmware (50 EUR first year, 60 EUR/year renewal).
  - Pre-configured Docker repository provided (docker-compose ready).
  - Hardware requirements: Raspberry Pi Zero 2 W or better (minimum supported hardware, not any device).
  - Zigbee USB stick is required (e.g. Sonoff CC2652P, ConBee II, etc.).
  - Early access to new software releases and beta features.
  - Backer recognition: your name permanently featured on the community backer wall.

## Frequently Asked Questions
- **Does it require internet?** No. Core automations, sensor telemetry, and Apple HomeKit work completely offline on your local network. Internet is optional for remote access and Alexa/Google Home.
- **Can I self-host?** Yes. Full REST API and OpenAPI 3.0 specs are available at https://upanet.org/docs/.
- **What sensors are supported?** Any standard Zigbee2MQTT sensor (SONOFF, Tuya, Aqara) plus Tasmota Wi-Fi relays.

## Guides & Documentation
- [Raspberry Pi Bluetooth Wi-Fi Setup](https://upanet.org/guides/raspberry-pi-bluetooth-wifi-setup): Headless network provisioning via BLE using NetworkManager.
- [Zigbee Thermostat & Heating Automation](https://upanet.org/guides/zigbee-thermostat-heating-automation): Per-room heating zone control with temperature sensors and boiler relays.
- [Garage Door Control with Zigbee Relay](https://upanet.org/guides/garage-door-zigbee-relay): Wiring low-voltage dry contacts to garage door openers for voice and app control.
- [Smart Home Security Sensors](https://upanet.org/guides/smart-home-security-sensors): Door contacts, motion sensors, water leak detectors, and vibration alerts.
- [Interactive API Documentation (Swagger)](https://upanet.org/docs/): Complete REST API documentation for self-hosters and developers.
- [OpenAPI Specification](https://upanet.org/openapi.json): Standard machine-readable OpenAPI 3.0 specification.
- [Source Code](https://github.com/paveurba/appapi): GitHub repository for the smarthomeapi backend.