# mKeRix/room-assistant

Presence tracking and more for automation on the room-level

Repository: https://github.com/mKeRix/room-assistant
Canonical: https://ross.abutalabs.com/products/room-assistant
Homepage: https://www.room-assistant.io
Language: TypeScript
License: MIT
License Family: permissive
Topics: home-automation, smart-home, home-assistant, bluetooth, thermopile, nodejs, docker, hassio, presence, presence-detection, sensors, hacktoberfest
Last push: 2026-08-25T02:40:32+00:00

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 8, longevity 100
- inputs: {"age_days": 3667, "days_push": 8, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1348, forks 125 (observed 2026-08-28T04:04:27.774280+00:00)

## What it is
room-assistant is a Node.js application for room-level home automation that tracks occupancy and people's location around the house using Bluetooth, thermopile sensors, and other integrations. It feeds this data into home automation suites like Home Assistant via MQTT or the Home Assistant API to enable per-room automations.

## Use cases
- track which room of the house people are in
- detect room occupancy even when people are sitting still
- turn lights and heating on only in occupied rooms
- track phones and smartwatches via bluetooth
- use thermal sensors like Omron D6T or Grid-EYE for presence detection
- integrate room sensor data with Home Assistant
- read temperature and humidity from Xiaomi Mi sensors
- attach GPIO binary sensors and shell commands

## When to choose
- you want accurate per-room presence tracking beyond simple motion sensors
- you use Home Assistant or MQTT-based home automation and want room-level data
- you want a modular, self-hosted presence detection setup on Raspberry Pis or similar devices

## When to avoid
- you need whole-home or outdoor GPS presence tracking rather than room-level
- you don't run any home automation hub or MQTT broker to consume the data
- you need a plug-and-play commercial solution without configuring distributed sensor instances

## Facets
- artifact type: application
- maturity: active
- function: iot, monitoring, workflow-automation
- domain: iot
- platform: iot, self-hosted
- tags: presence-detection, home-assistant, bluetooth, ble, thermopile, occupancy-tracking, mqtt, room-automation, typescript, sensors, home-automation, automation, nodejs, docker, linux

## Member repositories
- mKeRix/room-assistant (main) score 67

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:27.774280+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:42:25.819309+00:00, confidence not recorded.
  - readme: https://github.com/mKeRix/room-assistant (fetched 2026-08-28T04:04:27.774280+00:00, sha ccd9ebb6cb8d)
  - homepage: https://www.room-assistant.io (fetched 2026-08-29T12:01:48.084734+00:00, sha b95ac08b999e)
  - registry_npm: https://registry.npmjs.org/room-assistant (fetched 2026-08-29T12:01:48.088928+00:00, sha 1e8948d77523)
  - site_page: https://www.room-assistant.io/integrations (fetched 2026-08-29T12:01:48.087153+00:00, sha ef1bb2bbb848)
- Data as of 2026-08-30T08:39:29.467469+00:00.