1. Installing PyBluez

PyBluez can be installed on GNU/Linux, Windows and macOS systems and is compatible with Python 2.7 and 3.


Before you install PyBluez please install the dependencies required for your system as described in the sections below.

Installing PyBluez using pip

Open a terminal (command prompt on Windows) and enter

pip install pybluez

(there are also binaries for Windows platform on PyPI or here - Unofficial Windows Binaries for Python Extension Packages)

For experimental Bluetooth Low Energy support (only for Linux platform - for additional dependencies please take look at: ble-dependencies)

pip install pybluez\[ble\]

Installing PyBluez from source

Download a stable release from https://github.com/pybluez/pybluez/releases

or download the latest version using the links below.

master.zip master.tar.gz

Extract the zip or tar and cd to the extracted file directory, then:

python setup.py install

for Bluetooth Low Energy support (GNU/Linux only):

pip install -e .\[ble\]

1.1. GNU/Linux Dependencies

  • Python 2.7 or more recent version
  • Python distutils (standard in most Python distros, separate package python-dev in Debian)
  • BlueZ libraries and header files

1.2. Windows Dependencies

  • Windows 7/8/8.1/10
  • Python 3.5 or more recent version

PyBluez requires a C++ compiler installed on your system to build CPython modules.

For Python 3.5 or higher

  • Microsoft Visual C++ 14.0 standalone: Build Tools for Visual Studio 2017 (x86, x64, ARM, ARM64)
  • Microsoft Visual C++ 14.0 with Visual Studio 2017 (x86, x64, ARM, ARM64)
  • Microsoft Visual C++ 14.0 standalone: Visual C++ Build Tools 2015 (x86, x64, ARM)
  • Microsoft Visual C++ 14.0 with Visual Studio 2015 (x86, x64, ARM)


Windows 10 users need to download and install the Windows 10 SDK

More details here

  • Widcomm BTW development kit 5.0 or later (Optional)

1.3. macOS Dependencies