Skip to content
This repository was archived by the owner on Sep 4, 2025. It is now read-only.
JonahMMayPublic archive

About

Exposes internet search tools for use by LLM-backed Assist in Home Assistant

Resources

Stars

3 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

LLM Intents (Custom Integration for Home Assistant)

Additional tool intents for LLM-backed Assist for Home Assistant

Supported search sources:

  • Brave Search
  • Google Places
  • Wikipedia

Each intent is optional and configurable via YAML. Some require API keys, but are usable on free tiers.

TODOs:

  • Add UI capabilities for configuration
  • Implement proper error handling
  • Code optimization/cleanup

Installation

Install via HACS (recommended)

Have HACS installed, this will allow you to update easily.

  • Adding LLM Intents to HACS can be using this button: image

Note

If the button above doesn't work, add https://github.com/skye-harris/llm_intents as a custom repository of type Integration in HACS.

  • Click install on the LLM Intents integration.
  • Restart Home Assistant.
Manual Install

Configuration

After installation, configure the integration through Home Assistant's UI:

  1. Go to Settings → Devices & Services
  2. Click Add Integration
  3. Search for "LLM Intents"
  4. Follow the setup wizard to configure your desired services

🔍 Brave Search

Uses the Brave AI Web Search API to return summarized, snippet-rich results.

Requirements

Example Configuration

llm_intents:
  brave_search:
    api_key: !secret brave_ai_api
    num_results: 2
    country_code: "AU"
    latitude: -31.95
    longitude: 115.86
    timezone: "Australia/Perth"
    post_code: "6000"

Configuration Steps

  1. Select "Brave Search" during setup
  2. Enter your Brave "Data for AI" API key
  3. Configure optional settings like number of results, location preferences

Options

Key Required Default Description
api_key ✅ — Brave Search API key
num_results ❌ 2 Number of results to return
country_code ❌ — ISO country code to bias results
latitude ❌ — Optional latitude for local relevance
longitude ❌ — Optional longitude for local relevance
timezone ❌ — Timezone for contextual answers
post_code ❌ — Optional postcode for more accurate geo targeting

📍 Google Places

Searches for locations, businesses, or points of interest using the Google Places API.

Requirements

Example Configuration

llm_intents:
  google_places:
    api_key: !secret google_api
    num_results: 3

Configuration Steps

  1. Select "Google Places" during setup
  2. Enter your Google Places API key
  3. Configure number of results to return

Options

Key Required Default Description
api_key ✅ — Google Places API key
num_results ❌ 2 Number of location results to return

📚 Wikipedia

Looks up Wikipedia articles and returns summaries of the top results.

Requirements

  • No API key required.
  • Uses the public Wikipedia search and summary APIs.

Example Configuration

llm_intents:
  wikipedia: true

or

llm_intents:
  wikipedia:
    num_results: 1

Configuration Steps

  1. Select "Wikipedia" during setup
  2. Configure number of article summaries to return (no API key required)

Options

Key Required Default Description
num_results ❌ 1 Number of article summaries to return

Important

Security: All API keys are stored securely in Home Assistant's encrypted configuration database, not in plain text files.

Acknowledgements

Ruff

About

Exposes internet search tools for use by LLM-backed Assist in Home Assistant

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages