dlib linux python wheels

prebuilt python wheels for dlib on linux. fast installs, zero drama.

what is dlib

dlib is a modern c++ toolkit with machine learning and computer vision tools. python bindings let you use it without touching c++.

supported platforms

• architectures: x86_64, aarch64
• python versions: 3.11 to 3.14
• os: linux

quick start

download a wheel from releases and install with pip:

# python 3.11 x86_64
pip install dlib-19.24-cp311-cp311-linux_x86_64.whl

# python 3.12 aarch64
pip install dlib-19.24-cp312-cp312-linux_aarch64.whl

# python 3.13 x86_64
pip install dlib-19.24-cp313-cp313-linux_x86_64.whl

install directly from a release url:

pip install https://github.com/comethrusws/Dlib_linux_python_3.x/releases/download/manual-1/dlib-20.0.99-cp310-cp310-manylinux_2_39_x86_64.whl

system requirements

install runtime deps before installing the wheel.

ubuntu/debian

sudo apt-get update
sudo apt-get install -y \
  libboost-all-dev libopenblas-dev liblapack-dev libx11-dev \
  libgtk-3-dev libavcodec-dev libavformat-dev libswscale-dev \
  libv4l-dev libxvidcore-dev libx264-dev libjpeg-dev libpng-dev \
  libtiff-dev libatlas-base-dev

centos/rhel/fedora

sudo yum install -y \
  boost-devel openblas-devel lapack-devel libX11-devel gtk3-devel \
  ffmpeg-devel libjpeg-turbo-devel libpng-devel libtiff-devel atlas-devel

verify the install

import dlib
print("dlib version:", dlib.__version__)

detector = dlib.get_frontal_face_detector()
print("dlib installed correctly")

troubleshooting

• import errors: install runtime deps, then reinstall the wheel

• arch mismatch: wheel must match uname -m

  uname -m

• python mismatch: wheel must match python --version

  python --version

build from source (optional)

only needed if you require a custom build:

sudo apt-get install -y build-essential cmake libboost-all-dev
git clone https://github.com/davisking/dlib.git
cd dlib
python setup.py build
python setup.py install

how releases work

tag the repo, ci builds wheels for all supported python versions and both architectures, uploads artifacts, and attaches them to the release:

git tag v19.24
git push origin v19.24

license

dlib is distributed under its original license. see the license here: https://github.com/davisking/dlib/blob/master/dlib/LICENSE.txt

links

• dlib repo: https://github.com/davisking/dlib
• docs: http://dlib.net/
• python examples: https://github.com/davisking/dlib/tree/master/python_examples