integration-homekit

A MajorDom integration — bridges Apple HomeKit accessories into the MajorDom language.

Built for the MajorDom Hub, but it doesn't need it: this is a standalone, standardized library for HomeKit that you can use on its own (see Run it standalone below). Built on the MajorDom Integration SDK. The entry point is HomeKitController (majordom_homekit/controller.py), which the Hub — or the SDK's dev runner — instantiates and drives through its lifecycle: discovery → pairing → commands → teardown.

• Other protocols: browse the MajorDom integrations.
• Create your own: start from the integration template.

Documentation

Full integration-author docs — the controller lifecycle, data models, storing data, discovery, and a worked example — live at docs.majordom.io.

Development

poetry install && poetry run poe install

Work lands on develop; master is protected and released via Actions → Release. Tests drive the controller with the SDK's test doubles against an in-process fake HAP accessory server — no real accessory required (see tests/).

Run it standalone (without the Hub)

majordom-homekit is a standalone library — import it into your own app, or run just this integration interactively (discover, pair, control, and inspect devices from a prompt) with no Hub. It discovers IP accessories over mDNS; no external service is required.

See Standalone mode for the interactive CLI, watch mode, and the programmatic API.

About this integration

• Protocol / platform: Apple HomeKit Accessory Protocol (HAP) via the parker-aiohomekit fork of aiohomekit.
• Transport(s): IP (Wi-Fi / Ethernet, discovered via mDNS). BLE is not supported yet: discovery and pairing are in progress, and the transport stays disabled until the encrypted session is verified on hardware.
• Supported devices: HomeKit-compatible accessories — lights, plugs, switches, sensors, locks.
• Credentials needed to pair: code (the accessory's 8-digit HomeKit setup code).

Required harness

• Hardware adapters: none.
• Third-party software services: none — aiohomekit speaks HAP directly.
• OS / permissions: mDNS on the LAN for discovery.

Protocol stack (OSI)

Progress

• Discovery services registered (mDNS via zeroconf_discovery_service); cancel closures called in stop
• Discovery listeners fire and call controller_did_receive_discovery
• Re-discovery of already-paired accessories on reconnect (controller_did_connect_device)
• Device pairing (HAP pair-setup with the setup code)
• Device schema mapped: services/characteristics → parameter list with per-parameter metadata
• Hub → Device control (send_command)
• Device → Hub event subscription (controller_did_receive_events)
• identify
• unpair
• fetch
• Availability tracking while running (controller_did_lose_device / last_error)
• Graceful shutdown in stop
• Tests pass against a fake HAP accessory server (tests/)
• Owned — maintained by Parker Industries
• BLE accessories (discovery and pairing in progress; disabled until the encrypted session is verified on hardware)

Notes

Uses the parker-aiohomekit fork of aiohomekit; note its Python upper bound (<3.14).

License

See LICENSE. For commercial licensing or partnership inquiries regarding MajorDom, contact us via parker-industries.org/partnership.