# Project pack: Home Assistant @ 8a75c7d

Facts about **Home Assistant** for an AI following the [BespokeAI handover guide](https://handoff.bespokeai.software/guide/v4.md). Pinned to one version; never changes after publication.

> Home Assistant brings all your smart devices together in one app: lights, plugs, heating, door sensors, speakers and thousands more brands. Set up routines such as "turn the porch light on at sunset" or "tell me if the freezer door is left open". It runs on a small computer in your home, so it keeps working without the internet and your data stays with you. There is a phone app, a voice assistant and optional AI helpers.

## Setup path (checked 2026-11-03)
- **Needs Docker.** Tell the person before any setup work; no light non-Docker route is documented upstream. Runs as Home Assistant OS on a dedicated device or as a container; no plain Windows install was documented. Docker Desktop on Windows may need a computer restart and an admin-only Windows feature (virtualisation); say so and let the person decide.
- Verdict source: https://www.home-assistant.io/installation/
- You may be unable to download source archives or run commands in this session. The person downloads and runs things; if you cannot fetch something, give any changed file in full in chat with its path.

## Version and source
- Repository: https://github.com/home-assistant/core
- Pinned commit: `8a75c7d26dee678983db83ae50782c25f0a56637`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/home-assistant/core/archive/8a75c7d26dee678983db83ae50782c25f0a56637.zip
- Fresh checkout (only if you have a shell and git): use the commands below in an empty folder. If this exact source is already checked out, keep your branch and use the development command; do not clone again or reset local changes.
- Official docs: https://www.home-assistant.io/docs/
- Live demo: https://demo.home-assistant.io. Official demo with pretend devices. Nothing you do there affects a real home.
- Licence: **Apache-2.0**. Permissive. Use, change and share it for anything, including commercially. Keep the copyright and licence notices and say which files you changed. No obligation to publish your changes.

## Commands from the pinned source
- Developer commands (they may use Docker):

  ```sh
  git clone https://github.com/home-assistant/core bespoke-home-assistant
  cd bespoke-home-assistant
  git checkout --detach 8a75c7d26dee678983db83ae50782c25f0a56637
  # Prepare development requirements and local configuration first.
  # Setup notes: opens on http://localhost:8123
  script/setup && python3 -m homeassistant -c ./config
  ```

- Separate trial of the current upstream release (not your changes; sample data and a separate data directory only):

  ```sh
  docker run -d --name homeassistant --privileged --restart=unless-stopped -e TZ=Europe/London -v /PATH_TO_YOUR_CONFIG:/config -v /run/dbus:/run/dbus:ro --network=host ghcr.io/home-assistant/home-assistant:stable
  # then open http://localhost:8123 and create your owner account.
  # Beginners: Home Assistant OS on a Raspberry Pi or Home Assistant Green is easier and adds one-click apps (add-ons).
  ```
- Tools these commands use: A computer that stays on (Raspberry Pi 4/5, mini PC, NAS or Home Assistant Green), Docker on Linux for the container install, or Home Assistant OS, For development, Python 3.14 and uv (script/setup installs the rest)
- Develop: `script/setup && python3 -m homeassistant -c ./config   # opens on http://localhost:8123`
- Test: `uv run --no-sync pytest tests/components/<integration>`
- Check/lint: `uv run --no-sync prek run --all-files`
- Stack: python, yaml, typescript (asyncio, aiohttp, voluptuous, Jinja2 templates, Lit (frontend, separate repo home-assistant/frontend)). Difficulty for a non-developer with an AI: **moderate**. Almost all personal adaptation is configuration: automations, scripts, scenes, dashboards and YAML files in your config folder, all of which an AI can write for you. New device support is a custom integration in your config folder. Changing core itself is advanced: a very large Python codebase (1,500+ integrations) with strict tests and reviews, and the web interface lives in a separate repository (home-assistant/frontend).
- The project's own AI instructions, in the repository: `AGENTS.md`, `AI_POLICY.md`.
Personal data: **yes**. Stored in: Everything lives in your config folder (/config in Docker): configuration.yaml and the automation, script and scene files, secrets.yaml, a hidden .storage folder with settings made in the app, and the history database home-assistant_v2.db (SQLite by default). Secrets are entered by the person, never in chat.

---
Later, only when a step needs it: [reference.md](https://handoff.bespokeai.software/p/home-assistant/8a75c7d/r3/reference.md) (customisation points, must-keep-working, data and costs, coding conventions) · [hosting.md](https://handoff.bespokeai.software/p/home-assistant/8a75c7d/r3/hosting.md) (long-term hosting; hosts are paid third parties) · [bespoke.yaml](https://handoff.bespokeai.software/p/home-assistant/8a75c7d/r3/bespoke.yaml) · [SKILL.md](https://handoff.bespokeai.software/p/home-assistant/8a75c7d/r3/SKILL.md)