Installation

Via HACS (recommended)

1. Open HACS in the Home Assistant sidebar.
2. Click the ⋮ menu (top right) and select Custom repositories.
3. In the Repository field enter https://github.com/SeloraHomes/ha-selora-ai, set Category to Integration, and click Add.
4. Close the dialog, then use the search bar to find Selora AI.
5. Click Selora AI in the results, then click Download. Confirm the version and click Download again.
6. Restart Home Assistant.

After restarting, navigate to Settings → Devices & Services. You should see Selora AI listed under New devices discovered or available to add via + Add integration. Once configured, the quickest confirmation that everything is working is the Selora AI panel appearing in your HA sidebar — if you can see it and open the chat, the integration is live. If it does not appear, check Settings → System → Logs for errors.

Manual Installation

1. Download the latest release ZIP from the Releases page .

2. Unzip and copy the custom_components/selora_ai folder into your HA config directory. The exact path depends on how you run Home Assistant:

   Installation type	Config directory path
   Home Assistant OS / Supervised	/homeassistant/ (via Samba share or SSH add-on)
   Home Assistant Container (Docker)	The folder you mounted as /config
   Home Assistant Core	~/.homeassistant/ by default

   The final path should look like:

   <config>/custom_components/selora_ai/__init__.py
   <config>/custom_components/selora_ai/manifest.json
   ...
   

3. Restart Home Assistant.

After restarting, navigate to Settings → Devices & Services → + Add integration and search for Selora AI to confirm it is available. Once configured, the quickest confirmation that everything is working is the Selora AI panel appearing in your HA sidebar — if you can see it and open the chat, the integration is live. If it does not appear, verify the folder path above and check Settings → System → Logs for errors.