Install the SDK¶
Requires Python 3.10 or newer.
The PyPI distribution name is tap-python-sdk. The import name is tapsdk. Do not run pip install tapsdk — that package is not this SDK.
From PyPI¶
From source¶
For development (tests and flake8):
Platform prerequisites¶
macOS¶
Uses Apple CoreBluetooth via Bleak 3.x. If you use a non-system Python, install PyObjC for that interpreter.
Windows 10+¶
Uses Bleak 3.x with PyWinRT (installed via bleak). No external DLL is required.
Pair the Tap once via Settings > Bluetooth & devices > Add device before
connecting with the SDK. If a device connects but connect() returns
TapSDK when you expected TapSDK2, or
you see "Characteristic ... was not found!", fully unpair it and re-pair
through Settings rather than relying on the SDK's own scan/attach — see
Windows BLE connect notes for background.
Pass skip_scan=True to connect() to only attach to a Tap Windows already
reports as connected/paired, without falling back to a live BLE scan:
Linux¶
Install BlueZ tools and grant Bluetooth access:
sudo apt-get install bluez-tools libbluetooth-dev
sudo usermod -G bluetooth -a <username>
su - $USER
Uses Bleak 3.x with BlueZ. The device’s Bluetooth name must start with Tap for the Linux discovery path.