https://github.com/braytonstafford/grok_conversation
Home Assistant Conversation agent using xAI Grok LLM
https://github.com/braytonstafford/grok_conversation
grok hacs hacs-integration home-assistant xai
Last synced: 6 months ago
JSON representation
Home Assistant Conversation agent using xAI Grok LLM
- Host: GitHub
- URL: https://github.com/braytonstafford/grok_conversation
- Owner: braytonstafford
- Created: 2025-01-27T00:02:17.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2025-03-25T18:30:01.000Z (7 months ago)
- Last Synced: 2025-03-28T04:37:23.274Z (7 months ago)
- Topics: grok, hacs, hacs-integration, home-assistant, xai
- Language: Python
- Homepage:
- Size: 64.5 KB
- Stars: 14
- Watchers: 3
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# xAI Grok Conversation
This is a custom component of Home Assistant.
Derived from [OpenAI Conversation](https://www.home-assistant.io/integrations/openai_conversation/) but uses the xAI API URL [(https://api.x.ai/v1)](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]([text](https://docs.x.ai/docs)).
## Installation
1. Install via registering as a custom repository of HACS or by copying `grok_conversation` folder into `/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).
- [Generating an API Key](https://console.x.ai/)
6. Go to Settings > [Voice Assistants](https://my.home-assistant.io/redirect/voice_assistants/).
7. Click to edit Assistant (named "Home Assistant" by default).
8. Select "Grok" from "Conversation agent" tab.
Screenshot
## 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](https://braytonstafford.com/home-assistant-xai-grok-conversation-agent/)
## 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.