matter-ble-proxy
Python client library for the OHF Matter Server BLE proxy protocol
Decision gist · record as of 2026-08-14
Yes, if you are building or integrating with a Matter Server and need to separate BLE hardware from the server host. The library is actively maintained, has low install friction, carries a permissive Apache-2.0 license, and is designed for exactly this delegation pattern. Not relevant if your Matter Server and BLE adapter are on the same machine or if you do not need Matter protocol support.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.12+.
- Caller must implement BleScanSource and BleDeviceResolver abstract base classes; default Bleak-backed implementations are available in matter_ble_proxy.bleak_backend.
- Low friction: pure Python wheel with only two runtime dependencies (aiohttp, bleak).
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most integration scenarios including proprietary systems.
last release 2026-08-07 (7 days) · last repo commit 2026-08-13 · 292 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 79,496 downloads/mo, #14,353 on PyPI
Alternatives
Verify before relying
pip install matter-ble-proxy
from matter_ble_proxy import MatterBleProxy, BleScanSource, BleDeviceResolver
proxy = MatterBleProxy(
ws_url="ws://localhost:5580/ble",
scan_source=MyScanSource(),
device_resolver=MyDeviceResolver(),
)
await proxy.connect()
await proxy.run_until_closed()- Whether the library handles reconnection automatically or requires caller-managed retry logic.
- Performance characteristics and latency overhead of the WebSocket proxy layer compared to direct BLE access.
- Compatibility with specific Matter Server versions or protocol versions.
What it is and what it does
matter-ble-proxy is a Python client library that implements the OHF Matter Server's BLE proxy protocol, enabling a Matter Server running on a host without a BLE adapter to delegate Bluetooth operations to a separate process or device. It sits between a local BLE source and a remote Matter Server's `/ble` WebSocket endpoint, translating BLE scan results and device operations into the proxy protocol.
The library provides both a standalone CLI tool for testing and a pluggable library API. Integrators implement two abstract base classes—BleScanSource (to feed BLE advertisements) and BleDeviceResolver (to resolve device addresses)—then instantiate MatterBleProxy with a WebSocket URL and those implementations. The library deliberately does not manage reconnection; it releases all BLE resources and returns control when the WebSocket closes, leaving retry logic to the caller's supervisor.
Use it for
- Run a Matter Server on a host with no Bluetooth adapter while delegating BLE operations to a separate device with a BLE radio.
- Integrate Matter BLE bridging into Home Assistant by wiring its native Bluetooth component as the scan source and device resolver.
- Build a custom Matter gateway that aggregates BLE devices from multiple physical locations by running proxy instances on each site.
- Test a Matter Server's `/ble` endpoint in isolation without a full Home Assistant deployment using the bundled CLI.
- Implement a BLE proxy for home automation systems that need to speak Matter protocol over a network boundary.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are building or integrating with a Matter Server and need to separate BLE hardware from the server host.
The library is actively maintained, has low install friction, carries a permissive Apache-2.0 license, and is designed for exactly this delegation pattern. Not relevant if your Matter Server and BLE adapter are on the same machine or if you do not need Matter protocol support.
Install
matter-ble-proxy on PyPI
Before you install
Low friction: pure Python wheel with only two runtime dependencies (aiohttp, bleak). Active maintenance with a release 7 days old. Requires Python 3.12+, which is a hard constraint but clearly stated.
Requires Python 3.12+. Caller must implement BleScanSource and BleDeviceResolver abstract base classes; default Bleak-backed implementations are available in matter_ble_proxy.bleak_backend.
License in practice
Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most integration scenarios including proprietary systems.
Quickstart
pip install matter-ble-proxy
from matter_ble_proxy import MatterBleProxy, BleScanSource, BleDeviceResolver
proxy = MatterBleProxy(
ws_url="ws://localhost:5580/ble",
scan_source=MyScanSource(),
device_resolver=MyDeviceResolver(),
)
await proxy.connect()
await proxy.run_until_closed()Verify before relying
- Whether the library handles reconnection automatically or requires caller-managed retry logic.
- Performance characteristics and latency overhead of the WebSocket proxy layer compared to direct BLE access.
- Compatibility with specific Matter Server versions or protocol versions.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.12 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagesaiohttpbleak |
| Maintenance | Actively maintained 7 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 79,496 / month, #14,353 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaIntended Audience :: DevelopersProgramming Language :: Python :: 3.12Programming Language :: Python :: 3.13Topic :: Home Automation |
Evidence: matter_ble_proxy-1.4.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “matter server ble proxy client”
- matter-ble-proxyA Python client library that bridges BLE operations to a remote…
- bleak-esphomeProvides a Bleak backend that proxies Bluetooth Low Energy…
- python-matter-serverProvides a WebSocket-based Matter controller server that implements…
Give your agent the search over MCP, or paste the wish link into any chat.
More Home Automation packages
Represents and manipulates IPv4, IPv6, MAC addresses and related network objects; supports CIDR notation, subnetting, set operations, IANA lookups, and DNS reverse generation.
Home Assistant is an open-source home automation platform that centralizes control of smart home devices and automations on a local server or Raspberry Pi, prioritizing local control and privacy over cloud dependency.
Defines finite state machines and statecharts with a declarative Python API, supporting flat states, compound hierarchies, parallel regions, history states, guards, and both sync and async callbacks.
Install it if you need to model workflows, control logic, or any system with discrete states and event-driven transitions — from simple state machines to complex…
A Python library for controlling BlueZ Bluetooth adapters on Linux via the Management API, supporting both synchronous and event-driven command patterns.
An async Python library for controlling and monitoring Homematic and HomematicIP devices through multiple backend systems (CCU3, OpenCCU, Homegear, CUxD, CCU-Jack) using XML-RPC and JSON-RPC protocols.
Install it if you need to control Homematic devices from Python; the only constraint is a requirement for Python 3.14 or later and network access to a compatible…
Provides base classes and utilities for Home Assistant integrations to proxy HTTP and WebSocket traffic through Home Assistant's web server.
Install only if you are building a custom Home Assistant integration; it is not useful as a standalone package.
See also bleak-esphome · python-matter-server · kegtron-ble · simplepyble · aiobmsble · xiaomi-ble · smpclient · home-assistant-chip-clusters · home-assistant-chip-core