ikuai
dscao/ikuai · v2026.2.13
Home Assistant integration for iKuai Router
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
switch | Switch or outlet | |
sensor | Sensor (temperature, humidity, air quality…) | |
button | Button (as a switch) | |
device_tracker | Presence (as an occupancy sensor) |
What people report
iKuai routers are polled locally; v4.0 betas had online-list detection problems fixed by a community PR.
- Works1
- Partly works1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| iKuai 3.7.8 router | Works Local | Setup failed on cannot-connect; solved by correct address/portSaved copy添加集成报错如图。 集成版本 1.3.1 ikuai 系统版本：3.7.8 64位 Excerpt saved from GitHub on 2026-10-23. | Issue #7 · 2023-12 | |
| iKuai8 4.0.101 beta router | Partly works Local | Online device list failed; fix in PR 29 not in main releaseSaved copy已经修改过 掉线缓冲 刷新间隔 进行测试 ikuai版本 iKuai8_4.0.101_beta HA Core 2026.1.2 Frontend 20260107.2 日志 ``` 2026-02-15 21:48:09.511 ERROR (MainThread) [custom_components.ikuai.data_fetcher] Unexpected error in requestpost_json: 'utf-8' codec can't decode byte 0xf7 in position 8825: invalid start byte 2026-02-15 21:48:19.584 ERROR (MainThread) [custom_components.ikuai.data_fetcher] Unexpected error in requestpost_json: 'utf-8' codec can't decode byte 0xf7 in position 9783: invalid start byte 2026-02-15 21:48:29.504 ERROR (MainThread) [custom_components.ikuai.data_fetcher] Unexpected error in … Excerpt saved from GitHub on 2026-10-23. | Issue #28 · 2026-02 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local polling
Talks to the device on your network, asking it for updates every so often.
Details
| Installs (analytics) | 186 (0.03%) |
|---|---|
| GitHub stars | 94 |
| Latest version | 2026.2.13 (2026-02-16) |
| Set up in the UI | Yes |
| Maintainers | @dscao |
| License | Apache-2.0 |
Notable forks
Forks with stars, or with code pushed at least 90 days after the original’s last push. Useful when the original goes quiet.
| Fork | Stars | Last push | Description |
|---|---|---|---|
| noahBin23/hass-ikuai Newer code | ★ 1 | 2026-10-13 | Home Assistant integration for iKuai routers: native 4.x read-only sensors and legacy 3.x support |
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
Sources
- Documentation: https://github.com/dscao/ikuai
- Source code: https://github.com/dscao/ikuai
- Issues: https://github.com/dscao/ikuai/issues
- HACS: https://hacs.xyz
