Installation

A few questions point you to the right install path. Each path is detailed below.

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. Open your installation’s Overview.
3. Turn on the switch on the Selora AI card.

Your Selora Hub will automatically install the Selora AI integration (on Home Assistant 2026.10 and older, it installs HACS first), 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 the Home Assistant Marketplace

If you are not using a Selora Hub, the Home Assistant Marketplace is the easiest way to install Selora AI on any Home Assistant instance. It is built into Home Assistant 2026.11 and newer, so there is nothing to set up first. Click the button below:

Select Install, then restart Home Assistant when prompted.

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.

The Home Assistant Marketplace only offers stable releases. If the Selora team has asked you to test a fix, or you want a technology preview, see Pre-releases.

Manual installation

If you prefer not to use the Home Assistant Marketplace, 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.