majordom-integration-sdk

Models, protocols, and tooling for building MajorDom integrations.

An integration bridges an external protocol or platform (Matter, Zigbee, HomeKit, a vendor cloud, …) into the MajorDom language. This SDK is the contract: the schemas, the AbstractController framework, the device-repository protocol, discovery services, and a standalone dev runner so you can build and test an integration without a running Hub. The Hub itself depends on this same package — first-party integrations use no private shortcut.

Install

pip install majordom-integration-sdk

Requires Python 3.12+.

Also a standalone IoT toolkit

You don't need MajorDom to get value from this package. majordom_integration_sdk.discovery ships three fully working, standardized device-discovery services you can drop into any async Python project:

Zeroconf / mDNS (ZeroconfDiscoveryService) — browse Bonjour/mDNS services with a clean listener protocol, and — unusually — reliable disappearance tracking: it augments raw zeroconf with an active cache-poll + confirm-evict loop so you get accurate "device went away" events, not just arrivals.
SSDP / UPnP (SSDPDiscoveryService) — flexible, per-listener configurable search targets and refresh behavior over raw sockets, without dragging in a full UPnP stack.
BLE (BLEDiscoveryService) — a uniform listener interface over Bleak for advertisement scanning.

All three share one register(listener, …) → cancel shape, run standalone (each module has a runnable __main__ demo), and are a solid reference for implementing standardized interfaces over messy IoT protocols even if you never touch MajorDom. The AbstractController framework and the DeviceRepositoryProtocol + in-memory/SQLite implementations are equally reusable as a small, typed device-modelling toolkit.

Documentation

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

The fastest way to start a new integration is the integration-template repository (Use this template → Create a new repository).

License

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

Development

Setup:

poetry install && poetry run poe install

This installs dependencies and the pre-commit hook that runs poe check.

Task	Description
`poe install`	Install deps and register the pre-commit hook
`poe check`	Full quality pipeline (ruff, ty, pytest, poetry build/check)
`poe check --ci`	Same, plus `git diff --exit-code`

Two long-lived branches: develop (integration branch, all work lands here) and master (protected, released). Releases are cut from develop via Actions → Release; see ParkerIndustries/workflows for the CI/CD.

Development Status
- 4 - Beta
Intended Audience
- Developers
Operating System
- OS Independent
Programming Language
- Python :: 3
Topic
- Home Automation
- Software Development :: Libraries :: Application Frameworks

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

majordom_integration_sdk-0.1.5.tar.gz (43.1 kB view details)

Uploaded Jul 24, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

majordom_integration_sdk-0.1.5-py3-none-any.whl (53.3 kB view details)

Uploaded Jul 24, 2026 Python 3

File details

Details for the file majordom_integration_sdk-0.1.5.tar.gz.

File metadata

Download URL: majordom_integration_sdk-0.1.5.tar.gz
Upload date: Jul 24, 2026
Size: 43.1 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for majordom_integration_sdk-0.1.5.tar.gz
Algorithm	Hash digest
SHA256	`7f17d8fc2dba446f855d367c762aeca338f11c4db84d0ec32bf4624e61340669`
MD5	`997a382cb64dc3c3136478715763d3dc`
BLAKE2b-256	`5717768623b2f02ee00331186b32c832fcae4209bdebf0be9bfe71e3f403c27e`

See more details on using hashes here.

Provenance

The following attestation bundles were made for majordom_integration_sdk-0.1.5.tar.gz:

Publisher: release.yml on MajorDom-Systems/integration-sdk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: majordom_integration_sdk-0.1.5.tar.gz
- Subject digest: 7f17d8fc2dba446f855d367c762aeca338f11c4db84d0ec32bf4624e61340669
- Sigstore transparency entry: 2229994348
- Sigstore integration time: Jul 24, 2026
Source repository:
- Permalink: MajorDom-Systems/integration-sdk@f82d4c8a058605c1befacd0eaaff157ad51b90c6
- Branch / Tag: refs/heads/develop
- Owner: https://github.com/MajorDom-Systems
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@f82d4c8a058605c1befacd0eaaff157ad51b90c6
- Trigger Event: workflow_dispatch