This custom integration connects your Vector robot to Home Assistant over your local network.
After setup, Home Assistant can expose data from Vector, including:
- Current activity (sleeping, moving, charging, etc.)
- Battery percentage and battery details
- Lifetime stats (days alive, trigger-word reactions, seconds petted, distance moved)
- Orientation and lift diagnostics
- Stimulation data (disabled by default)
- Master volume control (disabled by default)
- Eye color preset control (disabled by default)
- Quick actions as buttons (sleep, go home, explore, listen for a beat, fetch cube)
- Vision camera entity (disabled by default)
- Nav map camera entity (disabled by default)
- Home Assistant actions/services:
vector.say_textvector.set_eye_color
- Home Assistant version:
2026.3.0or newer - Vector robot reachable on your local network
- Robot details:
- Robot name (
Vector-XXXXformat) - Host (IP address or hostname)
- Serial number (optional but recommended)
- Robot name (
You can use either of these modes:
- EscapePod/Wire-pod mode:
- Fill robot name, host, and serial
- DDL cloud mode:
- Fill robot name, host, serial, email, and password
- Email/password are only used for cloud auth data retrieval
- Home Assistant still talks to the robot locally via host
Open HACS in Home Assistant.Add this repository as a custom repository (category: Integration).InstallVector.Restart Home Assistant.
- Open HACS in Home Assistant.
- Go to the custom repositories section.
- Add
https://github.com/MTrab/vectoras categoryIntegration. - Find and install
Vectorin HACS. - Restart Home Assistant.
- Copy
custom_components/vectorinto your Home Assistantcustom_componentsdirectory. - Restart Home Assistant.
- Go to
Settings -> Devices & Services. - Click
Add Integrationand search forVector. - Enter your robot details.
- Discovery is supported via DHCP and Zeroconf/mDNS when available.
- Finish setup.
Some entities are disabled by default to keep dashboards clean.
To enable them:
- Open your Vector device in Home Assistant.
- Open the entity list.
- Enable entities like
Vision,Nav map,Volume,Stimulation, and diagnostic sensors as needed.
Use Home Assistant Actions (or services) under the vector domain:
vector.say_text- Required:
text - Optional:
device_id,use_vector_voice,duration_scalar,pitch_scalar
- Required:
vector.set_eye_color- Required:
rgb_color(RGB) - Optional:
device_id
- Required:
If you have multiple Vector devices, pass device_id to target a specific robot.
Use vector_face_seen as an event trigger in a Home Assistant automation. Vector
reports named faces through its event stream, and the integration fires the event
at most once every 60 seconds per name per robot.
The event data includes name (the enrolled name), face_id (the ID reported by
Vector), and entry_id (the Home Assistant config entry ID). You can filter the
trigger by name:
triggers:
- trigger: event
event_type: vector_face_seen
event_data:
name: AlexThe integration also fires vector_cube_seen when Vector reports seeing a Light
Cube. The event includes object_id (the ID reported by Vector) and entry_id.
It fires at most once every 60 seconds per object ID per robot.
- Confirm the robot host is correct and reachable from Home Assistant.
- Confirm robot name format is
Vector-XXXX. - Confirm serial is set.
- Email and password must both be set (or both left empty).
- Keep host/serial filled even when using DDL cloud mode.
- This can happen while the stream is not ready.
- If Vector is sleeping, the integration intentionally returns a sleep image.
- Communication with the robot is local-network first.
- Credentials are stored in Home Assistant config entry storage.
- This integration does not add telemetry endpoints.
This project is under active development. Behavior and exposed entities may improve or change between releases.
- Issues and feature requests: https://github.com/MTrab/vector/issues
