yalexs-ble

What it is and what it does

yalexs-ble is a Python library that communicates with Yale and August smart locks over Bluetooth Low Energy (BLE). It abstracts the BLE protocol and cryptographic handshake required by these locks, allowing developers to integrate lock control into Python applications—typically for home automation, access control systems, or smart home platforms.

The library depends on bleak for cross-platform BLE communication, bleak-retry-connector for resilient connections, cryptography for authentication, and async-timeout and lru-dict for performance. It targets modern Python (3.11+) and is actively maintained but marked Pre-Alpha, indicating the API may still evolve. With substantial monthly downloads, it serves a real user base despite its early status.

Use it for:

• Home automation platforms integrating Yale or August locks into a unified control system
• Building access control applications that unlock doors via BLE from a central Python service
• Smart home scripts that lock/unlock doors based on time, location, or other triggers
• IoT gateways bridging BLE locks to cloud platforms or local networks

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides Bluetooth control of Yale and August smart locks via a Python library, enabling remote lock/unlock operations and status monitoring over BLE.

Yes, with conditions. Install if you need BLE control of Yale or August locks in a Python application and accept GPL-3.0-only licensing. The low install friction, active maintenance, and healthy user base suggest it works in practice. Pre-Alpha status means the API may change; pin the version or monitor releases. No known vulnerabilities as of 2026-08-14.

Install

yalexs-ble on PyPI

pip install yalexs-ble

uv add yalexs-ble

poetry add yalexs-ble

Installing yalexs-ble

Before you install

Low install friction with a pure-Python wheel. Active maintenance (last commit 2026-08-11, release 18 days ago). Requires Python 3.11+. Six runtime dependencies including bleak for BLE communication and cryptography for lock authentication.

License in practice

GPL-3.0-only (copyleft): any derivative work or application linking this library must also be released under GPL-3.0-only. Suitable for open-source projects; commercial or proprietary integrations require careful licensing review.

Quickstart

pip install yalexs-ble

import asyncio
from yalexs_ble import YaleLock

async def main():
    lock = YaleLock(address="XX:XX:XX:XX:XX:XX")
    await lock.connect()
    await lock.unlock()

asyncio.run(main())

Requires Python 3.11+. Requires a compatible Yale or August lock within BLE range. BLE adapter must be present on the host system.

Verify before relying

• Which specific Yale and August lock models are supported by version 4.0.0
• Whether BLE range or connection reliability limitations exist beyond standard Bluetooth constraints
• API stability guarantees given Pre-Alpha development status
• Typical BLE operating range and connection reliability in practice

Package facts

Evidence: yalexs_ble-4.0.0-py3-none-any.whl

Tags

More Libraries packages