HIRI

HIRI is a smart-home bridge + firmware stack for Home Assistant and multi-ecosystem device adapters — local registry, MQTT discovery, REST API, ESP firmware, and client scaffolds.

Product: mergeos-bounties/HIRI

---

Table of contents

• Monorepo packages
• Highlights
• Screenshots
• Quick start (bridge)
• CLI reference
• Adapters
• Diagrams
• Architecture
• Safety
• Development
• MergeOS bounties
• License

---

Monorepo packages

Package	Path	Role
HIRI-bridge	packages/bridge	Device registry, adapters, HA MQTT discovery, FastAPI
HIRI-firmware	packages/firmware	ESP32 / ESP8266 firmware (PlatformIO) → MQTT → HA
HIRI-web	packages/web	User dashboard
HIRI-admin	packages/admin	Admin console (devices, adapters, logs)
HIRI-android / ios	packages/…	Mobile client scaffolds

Primary offline path: bridge (hiri-bridge demo).

---

Highlights

Capability	Description
Device registry	Seed + import devices; domains (light, fan, sensor, …)

---

Development

cd packages\bridge
pytest -q
ruff check src tests
hiri-bridge demo

Device Entity ID Naming

When creating device packs, follow the Device Entity ID Naming Conventions for consistent domain.object_id patterns.

---

MergeOS bounties

Device packs, bridge adapters, firmware, web/admin UX.
Star + claim → PR master → MRG 25–200. Evidence: discovery JSON snippet, HA entity screenshots, or flash notes.

---

License

MIT · MergeOS / ThanhTrucSolutions