Skip to main content

Python module that encapsulates wolfSSL's C SSL/TLS library.

Project description


wolfSSL Python, a.k.a. wolfssl is a Python module that encapsulates wolfSSL’s SSL/TLS library.

The wolfSSL SSL/TLS library is a lightweight, portable, C-language-based library targeted at IoT, embedded, and RTOS environments primarily because of its size, speed, and feature set. It works seamlessly in desktop, enterprise, and cloud environments as well.


The file covers most things you will need to do to build and install from source. As pre-requisites you will need to install either from your OS repository or pip. You’ll also need the Python development package for your Python version:

  • cffi

  • tox

  • pytest

To build a source package run python sdist, to build a wheel package run python bdist_wheel. To test the build run tox. The tox tests rely on Python 3.9 being installed, if you do not have this version we recommend using pyenv to install it.


We provide Python wheels (prebuilt binaries) for OSX 64 bits and Linux 64 bits:

$ pip install wheel
$ pip install wolfssl

To build wolfssl-py from source:

$ cd wolfssl-py
$ pip install .

The default pip install clones wolfSSL from GitHub. To build wolfssl-py using a local installation of the native wolfSSL C library, the USE_LOCAL_WOLFSSL environment variable should be set. USE_LOCAL_WOLFSSL can be set to “1” to use the default library installation location (/usr/local/lib, /usr/local/include), or to use a custom location it can be set to the install location of your native wolfSSL library. For example:

# Uses default install location
$ USE_LOCAL_WOLFSSL=1 pip install .

# Uses custom install location
$ USE_LOCAL_WOLFSSL=/tmp/install pip install .


To run the tox tests in the source code, you’ll need tox and a few other requirements.

  1. Make sure that the testing requirements are installed:

sudo -H pip install -r requirements/test.txt
  1. Run make check:

$ make check
_________________________________ summary _________________________________
py3: commands succeeded
congratulations :)


For support and questions, please email

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wolfssl-5.3.0.post0.tar.gz (43.0 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page