Installation

Via Selora Hub (one-click)

If you have a Selora Hub , Selora AI can be enabled with a single toggle — no manual installation required.

1. Log in to your Selora Homes account.
2. Navigate to the settings for your installation.
3. Toggle Selora AI to on.

Your Selora Hub will automatically install HACS and the Selora AI integration, and configure Selora AI Cloud as the LLM backend using the credits included with your subscription. No API keys, provider selection, or authentication flow are required. Once complete, Selora AI appears in the Home Assistant sidebar, ready to use.

For full details, see the Selora AI on Selora Hub guide.

Via HACS

If you are not using a Selora Hub, HACS is the easiest way to install Selora AI on any Home Assistant instance.

First, make sure HACS is installed on your Home Assistant instance, then click the button below:

After installing, restart Home Assistant.

Once restarted, 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

If you prefer not to use HACS, you can install the integration manually.

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.