# Home Assistant — Open-Source Home Automation That Puts Local Control First

> Home Assistant is the most popular open-source platform for smart home automation. It integrates 3,000+ devices and services, runs entirely on local hardware (Raspberry Pi to NUC), and keeps your data off the cloud by default.

## Install

Save as a script file and run:

# Home Assistant — Local-First Smart Home Platform

## Quick Use
```bash
# Home Assistant OS (recommended) — flash to SD card / SSD
# https://www.home-assistant.io/installation/

# Docker (Container install)
docker run -d \
  --name homeassistant \
  --privileged \
  --restart=unless-stopped \
  -e TZ=America/New_York \
  -v /PATH_TO_YOUR_CONFIG:/config \
  --network=host \
  ghcr.io/home-assistant/home-assistant:stable

# Open http://<host>:8123
```

## Introduction
Home Assistant is the smart home platform cloud providers wish they could compete with. With 3,000+ integrations (Zigbee, Z-Wave, Matter, HomeKit, Nest, Ring, Philips Hue, Shelly, Tesla, EV chargers, solar inverters...), it unifies every device under one dashboard — running on your own hardware.

With over 86,000 GitHub stars, Home Assistant is the largest open-source smart-home project in the world. The Open Home Foundation (which owns the project) ensures local-first, user-friendly, privacy-respecting smart homes as a long-term goal.

## What Home Assistant Does
Home Assistant discovers devices on your network, exposes them as "entities" (lights, sensors, switches, media players), and lets you build automations in the UI, YAML, or a built-in script engine. Lovelace dashboards give you mobile + desktop control. HACS (Home Assistant Community Store) extends it with 1,500+ community integrations.

## Architecture Overview
```
[Home Assistant Core (Python)]
        |
[Integrations]                             [Devices]
  Zigbee2MQTT   <--MQTT-->   ZHA / HA           Zigbee bulbs/sensors
  Z-Wave JS     <--WS-->     Z-Wave JS UI       Z-Wave devices
  Matter        <--IP-->     Matter Server      Matter devices
  HomeKit, Nest, Google, Alexa, Shelly, ...    Cloud APIs / LAN devices
        |
[Entity Registry] --> states + attributes + state_changed events
        |
[Automation Engine]
   triggers (time, state, event)
   conditions (state, numeric, template)
   actions (service calls, scenes)
        |
[Lovelace Dashboards]    [Voice Assistant]   [Companion App]
   drag-n-drop UI          Piper + Whisper    iOS/Android push
```

## Self-Hosting & Configuration
```yaml
# automations.yaml — turn off all lights at bedtime
alias: "Bedtime lights off"
trigger:
  - platform: time
    at: "23:30:00"
condition:
  - condition: state
    entity_id: input_boolean.bedtime_mode
    state: "on"
action:
  - service: light.turn_off
    target:
      area_id: ["bedroom", "living_room", "kitchen"]
  - service: notify.mobile_app_phone
    data:
      message: "Lights off. Good night."

# Blueprint-based: "Sensor light" pattern (one import, reusable)
# Studio Code Server add-on lets you edit YAML from the UI
```

```bash
# HACS — Home Assistant Community Store
# Install via UI: Add-ons -> HACS
# Gives access to custom integrations + custom Lovelace cards

# Popular add-ons:
# - ESPHome         flash ESP32/ESP8266 via the HA UI
# - Node-RED        visual flow-based automations
# - Mosquitto       built-in MQTT broker
# - Zigbee2MQTT     Zigbee without proprietary bridges
# - Whisper/Piper   local STT/TTS for voice assistant
```

## Key Features
- **3,000+ official integrations** — every major smart-home brand
- **Local control** — LAN protocols (MQTT, Matter, Zigbee) + direct device APIs
- **Privacy-respecting** — your data lives on your hardware; cloud is optional
- **Dashboards (Lovelace)** — polished mobile + desktop UI
- **Automations + Scripts** — visual editor, YAML, or Python AppDaemon
- **Voice assistant** — local Whisper + Piper for offline voice control
- **Energy dashboard** — track solar + battery + grid with detailed stats
- **HACS** — 1,500+ community integrations and custom cards

## Comparison with Similar Tools
| Feature | Home Assistant | OpenHAB | Domoticz | HomeKit | Google Home |
|---|---|---|---|---|---|
| Integrations | 3,000+ | 450+ | 200+ | Apple-only ecosystem | Google-only ecosystem |
| Local-first | Yes | Yes | Yes | Mostly | Mostly cloud |
| Open source | Yes | Yes | Yes | No | No |
| Community + docs | Huge | Good | Moderate | Apple docs | Google docs |
| Dashboard UX | Excellent | OK | OK | Apple polish | Google polish |
| Best For | Any smart home, power users | Java-centric installs | Lightweight | Apple-only homes | Google-only homes |

## FAQ
**Q: What hardware should I use?**
A: For beginners: Home Assistant Green ($99 official box) or Raspberry Pi 4/5 + SSD. For larger installs: Intel N100 mini-PC running HA OS on bare metal or Proxmox.

**Q: Does my ISP router need changes?**
A: No, but many protocols benefit from multicast + IPv4 LAN (most consumer routers support this out of the box). VLAN segmentation is a great practice for IoT security.

**Q: Cloud vs local?**
A: Home Assistant Cloud (Nabu Casa, $6.50/mo) gives you remote access + Alexa/Google voice integration. Or self-configure via WireGuard / Tailscale for zero-cost remote access.

**Q: Is it hard to learn?**
A: Moderate. The UI handles 90% of automations. Writing advanced YAML / Jinja templates has a curve but massive community tutorials exist.

## Sources
- GitHub: https://github.com/home-assistant/core
- Website: https://www.home-assistant.io
- Foundation: Open Home Foundation
- License: Apache-2.0

---
Source: https://tokrepo.com/en/workflows/2fef4503-381e-11f1-9bc6-00163e2b0d79
Author: Script Depot