---
id: yalexs-ble
version: "4.0.0"
license: GPL-3.0-only
license_treatment: copyleft
maintenance: active
---

# yalexs-ble — Bluetooth control of Yale and August locks

License: copyleft · Maintenance: active · Downloads: 77.3K/mo

## 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 above — 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

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

- License: GPL-3.0-only (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 77.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

bluetooth smart lock control, yale august lock ble, smart lock python library, bluetooth lock automation, yale lock remote control, ble-hardware, smart-locks, home-automation

[View on SkillFed](https://skillfed.io/packages/yalexs-ble) · [View on PyPI](https://pypi.org/project/yalexs-ble/)