Voice Satellite Home Assistant: trợ lý giọng nói

Voice Satellite Home Assistant là một integration mã nguồn mở biến trình duyệt, máy tính bảng hoặc điện thoại thành trợ lý giọng nói hands-free cho Home Assistant. Repo này giải quyết bài toán cần một thiết bị satellite giá rẻ, riêng tư, không phụ thuộc cloud, phù hợp với người đã có Home Assistant và muốn nói chuyện với nhà thông minh như Alexa, Siri hay Google Home nhưng tự chủ phần cứng. Bạn có thể xem toàn bộ mã nguồn tại repository Voice Satellite trên GitHub.

Nội dung

Thank you for reading this post, don't forget to subscribe!

Những điểm chính

Voice Satellite biến mọi trình duyệt, tablet hay điện thoại thành trợ lý giọng nói cho Home Assistant mà không cần thêm phần cứng đắt tiền.
Wake word được phát hiện ngay trên thiết bị qua ba engine khác nhau, không cần add-on chạy server-side.
Integration tạo ra thiết bị assist_satellite thật, hỗ trợ media player, timer, thông báo và tương thích với automation.
Kiosk Satellite mở rộng khả năng cho tablet Android: nhận wake word khi màn hình tắt, khởi động cùng máy và giảm tải CPU so với chạy trong trình duyệt.
Dự án phát hành theo giấy phép AGPL v3 và hiện không nhận pull request, chỉ nhận issue từ cộng đồng.

Voice Satellite Home Assistant là gì và giải quyết vấn đề gì?

Voice Satellite là một drop-in integration giúp trình duyệt web trở thành một Assist satellite đầy đủ, với wake word, phát media và phản hồi trực quan. Thay vì mua loa thông minh hoặc dựng một thiết bị chuyên dụng, bạn có thể tận dụng tablet treo tường, điện thoại cũ hoặc máy tính đang mở sẵn giao diện Home Assistant.

Điểm đáng chú ý là nó chạy như một engine toàn cục trên mọi trang Home Assistant, không yêu cầu dashboard card. Sau khi gán satellite entity trong sidebar, engine tự động lắng nghe wake word. Audio chỉ được truyền về Home Assistant sau khi wake word kích hoạt, nên phần lớn quá trình xử lý vẫn nằm trên thiết bị của bạn. Điều này giúp giảm phụ thuộc vào cloud và tăng độ riêng tư so với trợ lý phổ thông.

Những tính năng nổi bật của Voice Satellite là gì?

Voice Satellite không chỉ dừng ở việc nhận lệnh thoại; nó được thiết kế để hoạt động như một satellite thực thụ trong hệ sinh thái Home Assistant. Dưới đây là các nhóm tính năng chính được nêu trong README.

Wake word chạy trên thiết bị với ba engine

Engine mặc định cho cài đặt mới là microWakeWord, chạy CPU thuần JavaScript nên tương thích với gần như mọi thiết bị. vsWakeWord dùng WebGPU và được huấn luyện cho tablet treo tường, hứa hẹn độ nhận diện cao và ít false positive. openWakeWord cũng dùng WebGPU, có thư viện keyword đa dạng và gần như miễn phí khi thêm nhiều wake word cùng lúc.

Hệ thống cho phép chạy hai wake word song song, mỗi cái gắn với một Assist pipeline riêng. Nhờ đó, một nhà có thể trộn ngôn ngữ hoặc dùng pipeline local cho một người và pipeline cloud/LLM cho người khác.

Media player và visual feedback

Mỗi satellite được đăng ký như một thiết bị assist_satellite thật, kèm media player loại TV-class. Nó có thể phát audio, video local, luồng camera HLS hoặc MJPEG toàn màn hình, hỗ trợ tts.speak và media_player.play_media từ automation. Màn hình overlay hiện phản hồi trực quan với skin, activity bar và timer pill.

Timers, announcements và LLM tools

Bạn có thể ra lệnh hẹn giờ bằng giọng nói, và timer cũng có thể được khởi động từ automation qua action voice_satellite.start_timer. Integration còn hỗ trợ assist_satellite.announce, start_conversation, ask_question và voice_satellite.show để chạy prompt theo lịch rồi ghim kết quả lên màn hình. Nhánh LLM tools thử nghiệm bổ sung tìm kiếm web, hình ảnh, video, thời tiết, chứng khoán và tiền mã hóa, nhưng yêu cầu cài thêm integration Voice Satellite – LLM Tools riêng.

Hướng dẫn cài đặt Voice Satellite

Trước khi cài, bạn cần Home Assistant 2025.6.1 trở lên và một Assist pipeline đã cấu hình đủ Speech-to-Text, Conversation Agent và Text-to-Speech. Trình duyệt phải có quyền truy cập microphone và được phục vụ qua HTTPS.

Cài đặt nhanh bằng HACS

Mở HACS trong Home Assistant.
Tìm kiếm Voice Satellite trong kho mặc định của HACS.
Chọn repository Voice Satellite và cài đặt.
Khởi động lại Home Assistant nếu được yêu cầu.

Cài đặt thủ công

Tải file ZIP phiên bản mới nhất từ trang release của repository.
Giải nén và copy thư mục custom_components/voice_satellite vào thư mục config/custom_components.
Khởi động lại Home Assistant.

Thiết lập satellite cho từng trình duyệt

Vào Settings → Devices & Services → Add Integration.
Tìm Voice Satellite, đặt tên cho thiết bị, ví dụ Kitchen Tablet.
Lặp lại cho mỗi trình duyệt hoặc tablet sẽ làm satellite.
Mở sidebar Voice Satellite, chọn satellite entity vừa tạo.
Cấu hình wake word, audio và giao diện. Engine tự khởi động sau khi đã gán entity.

Nếu trình duyệt chặn auto-start vì thiếu user gesture, một nút microphone nổi sẽ xuất hiện để bạn bấm khởi động thủ công. Sidebar panel chứa phần Diagnostics & troubleshooting, có thể chạy kiểm tra tự động về secure context, quyền microphone, pipeline và tài nguyên Lovelace. Nút Copy report tạo sẵn nội dung markdown để dán vào GitHub issue.

Ai nên dùng và ai không nên dùng?

Voice Satellite phù hợp với người dùng Home Assistant đã có Assist pipeline hoạt động, đang cần một màn hình cảm ứng treo tường hoặc trình duyệt dư để làm trợ lý gia đình. Nó đặc biệt hữu ích khi bạn muốn tạo hệ thống voice assistant riêng tư, không gửi dữ liệu giọng nói lên cloud.

Ngược lại, nếu bạn chưa từng cấu hình Assist pipeline, chưa có STT/TTS hoặc chỉ muốn thử nhanh mà không muốn đụng vào cấu hình Home Assistant, bạn sẽ mất thời gian ban đầu. Những ai dùng tablet Android để làm kiosk với màn hình tắt thường xuyên cũng nên cài Kiosk Satellite; nếu chỉ chạy trong trình duyệt thông thường, microphone sẽ ngừng hoạt động khi màn hình tắt. Với người dùng iOS, Kiosker Pro vẫn được hỗ trợ nhưng cần bật quyền microphone và dùng screensaver thay vì tắt màn hình.

Voice Satellite có hạn chế gì khi dùng trên trình duyệt?

Trình duyệt là nền tảng tiện lợi nhưng cũng có nhiều giới hạn. Nếu màn hình thiết bị tắt hoàn toàn, microphone sẽ ngừng hoạt động. Nếu Home Assistant không được phục vụ qua HTTPS, trình duyệt hiện đại sẽ chặn quyền truy cập microphone. Ngoài ra, phát hiện wake word trong trình duyệt có thể nặng với tablet cấu hình thấp, còn máy yếu có thể gặp khó khăn khi chạy WebGPU.

Home Assistant Companion App cũng cần được bật Autoplay videos trong Settings → Companion App → Other settings, nếu không WebView sẽ chặn phát TTS. Các kiosk app như Fully Kiosk Browser hoặc Kiosker Pro vẫn hoạt động, nhưng bạn phải bật quyền microphone và dùng screensaver thay vì tắt màn hình để giữ mic hoạt động. Về mặt đóng góp, dự án hiện chỉ nhận issue và không nhận pull request, nên nếu bạn muốn sửa code trực tiếp, cần fork riêng.

Hoạt động bên trong Kiosk Satellite khác gì trình duyệt?

Kiosk Satellite là ứng dụng Android chính thức, miễn phí, được xây dựng riêng cho Home Assistant. Khi Voice Satellite phát hiện đang chạy bên trong Kiosk Satellite, nó chuyển việc nhận diện wake word cho engine native của ứng dụng, nhưng bạn vẫn cấu hình mọi thứ trong Voice Satellite như bình thường. Setup wizard của app thậm chí tự gán satellite entity.

So với trình duyệt, Kiosk Satellite giúp nghe wake word khi màn hình tắt hoặc khi ứng dụng khác đang mở, quay lại dashboard ngay khi kích hoạt, nhận microphone trên các instance HTTP không có HTTPS, giảm chi phí CPU nhờ native inference nhanh hơn 10 đến 30 lần, và khởi động cùng máy. Ngoài ra, đây cũng là một kiosk app hoàn chỉnh với lockdown, PIN, screensaver và web admin.

Câu hỏi thường gặp

Voice Satellite có cần thêm add-on wake word chạy trên server không?

Không. Cả ba engine wake word đều chạy trực tiếp trong trình duyệt bằng JavaScript, nên không cần add-on phát hiện wake word chạy nền trên server. Audio chỉ được truyền về Home Assistant sau khi có wake word kích hoạt, giúp giảm tải và giữ dữ liệu giọng nói ở thiết bị lâu hơn.

Voice Satellite có miễn phí không?

Repository được phát hành theo giấy phép AGPL v3, nghĩa là mã nguồn mở và bạn có thể tự chạy. Kiosk Satellite cho Android cũng được mô tả là ứng dụng chính thức miễn phí. Tuy nhiên, chi phí thực tế nằm ở tài nguyên Home Assistant và dịch vụ STT/LLM/TTS nếu bạn dùng pipeline cloud.

Voice Satellite có chạy được trên điện thoại không?

Có. README ghi rõ sản phẩm hoạt động trên tablet, điện thoại, máy tính và kiosk. Bạn chỉ cần cấp quyền microphone, đảm bảo HTTPS và giữ màn hình không tắt hoàn toàn khi dùng trình duyệt thông thường. Nếu dùng Android, Kiosk Satellite giúp loại bỏ hai giới hạn màn hình tắt và HTTPS.

Voice Satellite có hỗ trợ tiếng Việt không?

README không đề cập trực tiếp tiếng Việt. Vì Voice Satellite dùng Assist pipeline, khả năng tiếng Việt phụ thuộc hoàn toàn vào model Speech-to-Text, conversation agent và Text-to-Speech bạn cấu hình trong Home Assistant. Bạn nên kiểm tra model cụ thể trước khi chọn làm trợ lý chính.

Kết luận

Voice Satellite là một cách thực tế để tận dụng tablet, điện thoại cũ hoặc trình duyệt luôn mở thành trợ lý giọng nói riêng tư cho Home Assistant. Nó có hệ sinh thái tính năng rõ ràng: ba engine wake word, dual pipeline, media player, timer, announcement, skin và Kiosk Satellite hỗ trợ tốt cho Android. Nếu bạn đã có Assist pipeline và đang tìm giải pháp không phụ thuộc cloud, hãy thử cài Voice Satellite qua HACS trên một thiết bị dư và tự đánh giá độ ổn định trước khi đầu tư thêm kiosk app.