Skip to content

braytonstafford/grok_conversation

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 

Repository files navigation

xAI logo

xAI Grok Conversation

This is a custom component of Home Assistant.

Derived from OpenAI Conversation but uses the xAI API URL (https://api.x.ai/v1).

How it works

xAI Grok Conversation uses OpenAI's python package to call to call the xAI API URL to interact with the latest version of the Grok LLM, see xAI documentation.

Installation

  1. Install via registering as a custom repository of HACS or by copying grok_conversation folder into <config directory>/custom_components

  2. Restart Home Assistant

  3. Go to Settings > Devices & Services.

  4. In the bottom right corner, select the Add Integration button.

  5. Follow the instructions on screen to complete the setup (API Key is required).

  6. Go to Settings > Voice Assistants.

  7. Click to edit Assistant (named "Home Assistant" by default).

  8. Select "Grok" from "Conversation agent" tab.

    Screenshot Select a conversaion agent in Home Assistant

Installation Walkthrough with Screenshots

A blog post walk-through on generating an API key, adding the custom repository, and setting up the integration can be found here

Preparation

After installed, you need to expose entities from "https://{your-home-assistant}/config/voice-assistants/expose" for the entities/devices to be controlled by your voice assistant.