Installation

Install Extended OpenAI Conversation via HACS or manually

Prerequisites

• Home Assistant instance
• OpenAI API key (How to generate)

Installation Methods

HACS (Recommended)

Install via HACS

1. Install integration

   1. Click the button above or open HACS in Home Assistant
   2. Go to “Integrations”
   3. Click ”+ Explore & Download Repositories”
   4. Search for “Extended OpenAI Conversation”
   5. Click “Download”
   6. Restart Home Assistant

Manual Installation

Manual Installation

1. Download files

   Download the extended_openai_conversation folder from the repository

2. Copy to custom_components

   Copy the folder to <config directory>/custom_components/

   Your directory structure should look like:

   <config>/
   └── custom_components/
       └── extended_openai_conversation/
           ├── __init__.py
           ├── manifest.json
           └── ...
   
3. Restart

   Restart Home Assistant

Setup

1. Add integration

   1. Click the button above or go to Settings > Devices & Services
   2. Click Add Integration button (bottom right)
   3. Search for “Extended OpenAI Conversation”
   4. Follow the setup wizard
2. Enter API key

   Provide your OpenAI API key during setup.

   If using OpenAI-compatible servers (Azure OpenAI, LocalAI, etc.), specify the “Base URL” during setup. Otherwise, leave it as the default.

   For local LLM servers (Ollama, LM Studio, etc.), you can enter any value for the API key as it’s not validated by local servers.

3. Configure voice assistant

   1. Go to Settings > Voice Assistants
   2. Click to edit your Assistant (named “Home Assistant” by default)
   3. Select Extended OpenAI Conversation from the “Conversation agent” dropdown

   

Expose Entities

You must expose entities for the AI to control them. Without exposed entities, the assistant won’t know what devices are available.

1. Navigate to: http://{your-home-assistant}/config/voice-assistants/expose
2. Select entities you want the AI to control
3. Enable the toggle for each entity

Verify Installation

Test your setup by asking the assistant a simple question:

"What lights are available?"

If configured correctly, the assistant should respond with a list of your exposed light entities.

Next Steps

Configuration

Customize options and behavior

Functions

Learn about function types