ha-voice-label-sync 0.2.0.dev0

Generate voice assistant configuration from Home Assistant labels.

Automatically generate your voice assistant configuration from Home Assistant labels.

🚧 Early development project

Feedback and ideas are welcome.

Why?

Do you maintain dozens of Google Assistant entities manually?

Managing voice assistant configurations manually quickly becomes difficult.

HA Voice Label Sync automatically generates the required configuration from Home Assistant labels, making your labels the single source of truth.

With the current release you can:

Stop maintaining large YAML files manually. Avoid duplicated configuration. Keep Home Assistant as the only place where entities are managed. Generate your configuration in seconds.

Current Status

Project status

HVLS is currently under active development.

Latest stable release: v0.1.2

Current development version: 0.2.0.dev0

Current capabilities:

• Standalone CLI
• Reusable Python core
• Google Assistant YAML generation
• Dry-run support
• Safe atomic file writing
• Automatic backups and retention
• Initial Home Assistant integration skeleton

Not yet available:

• Full Home Assistant configuration UI
• Home Assistant actions and buttons
• Backup restoration from the UI
• HACS installation

HA Voice Label Sync has been designed to support multiple voice assistants.

• Currently supported :

  ✅ Google Assistant
  

• Planned :

  Amazon Alexa
  Apple HomeKit
  

Instead of maintaining a long list of exposed entities manually, simply assign a label in Home Assistant, run the script, and let HA Voice Label Sync generate the configuration for you.

Features

• Select entities using a Home Assistant label
• Generate entity_config for Google Assistant
• Use Home Assistant friendly names
• Use Home Assistant areas as Google rooms
• Ignore disabled or hidden entities
• Dry-run mode before writing the file

How it works

                           Home Assistant
                                │
                                ▼
                              Labels
                                │
                                ▼
                        Voice Assistant Sync
                                │
                         ┌──────┴───────┐
                         │              │
               Google Assistant    Amazon Alexa
       

Generated entity_config

switch.prise_pompe:
  expose: true
  name: Pompe piscine
  room: Piscine

Home Assistant configuration

google_assistant:
  project_id: YOUR_PROJECT_ID
  service_account: !include google_key.json
  report_state: true
  expose_by_default: false
  entity_config: !include google_assistant_entities.yaml

Quick start

Installation

Option 1 – Download the script

Download the latest version of ga_label_sync.py from the repository.

Copy it to your Home Assistant scripts directory.

Typical locations are:

/config/scripts/

or

<home-assistant-config>/scripts/

depending on your Home Assistant installation.

Option 2 – Clone the repository

git clone https://github.com/flimo44/ha-voice-label-sync.git

The script is located in:

scripts/ga_label_sync.py

If you simply want to use the script, downloading scripts/ga_label_sync.py is enough.

Cloning the repository is recommended only if you plan to follow development or contribute to the project.

Usage :

Step 1 — Add the label

Step 2 — Preview the generated configuration

python3 /config/scripts/ga_label_sync.py --label "google_assistant" --dry-run

# --- Couloir ---
lock.serrure_maison:
  expose: true
  name: Serrure porte entrée
  room: Couloir

# --- Jardin ---
switch.portail:
  expose: true
  name: Portail
  room: Jardin

# --- Piscine ---
input_select.piscine_mode_gestion:
  expose: true
  name: "Piscine - Mode Gestion"
  room: Piscine

switch.piscine_chauffage:
  expose: true
  name: Pac Piscine
  room: Piscine

switch.prise_pompe2:
  expose: true
  name: Pompe piscine
  room: Piscine

Step 3 — Generate the file

python3 /config/scripts/ga_label_sync.py --label "google_assistant"

Step 4 — Restart Home Assistant

Step 5 — Synchronize Google Home

Google Home before synchronization

Google Home after synchronization

License MIT