openHAB

# Chat

The Chat feature allows you to control your smart home using natural language and interact with your devices conversationally. It requires a LLM-based human language interpreter to be configured as the default interpreter.

Upon sending a message, it is processed by the LLM and the response is displayed in the chat feed. When the LLM decides to interact with Items using LLM tools, the default card widget for the interacting Item is rendered in the chat feed, allowing to check the status or control the Item directly.

# Settings

The icon in the bottom right corner provides access to the following settings:

  • Tool Customization: Allows you to select which LLM tools are provided to the LLM. Disabling tools prevents the LLM from executing any actions.
  • Tool Call Display: Toggle whether all tool calls are displayed. If disabled, only the Item-related tool calls are rendered. If enabled, other tool calls (such as time/date queries) will be displayed in generic components.

# Requirements

To use the Chat interface, you must configure the following on your openHAB server:

  1. Compatible Interpreter: You need a LLM-based HLI service, such as Google Gemini.
  2. Default Interpreter: Configure this HLI service as your default interpreter in System Settings → Voice.
Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)

← Things →