Skip to main content

Python bindings for the Delta Chat Core library using CFFI against the Rust-implemented libdeltachat

Project description

This package provides bindings to the deltachat-core Rust -library which provides imap/smtp/crypto handling as well as chat/group/messages handling to Android, Desktop and IO user interfaces.

Installing pre-built packages (linux-only)

If you have a linux system you may install the deltachat binary “wheel” package without any “build-from-source” steps.

  1. Install virtualenv, then create a fresh python environment and activate it in your shell:

    virtualenv -p python3 venv
    source venv/bin/activate

    Afterwards, invoking python or pip install will only modify files in your venv directory and leave your system installation alone.

  2. Install the wheel for linux:

        pip install deltachat
    Verify it worked by typing::
        python -c "import deltachat"

Installing a wheel from a PR/branch

For Linux, we automatically build wheels for all github PR branches and push them to a python package index. To install the latest github master branch:

pip install -i deltachat

Installing bindings from source

If you can’t use “binary” method above then you need to compile to core deltachat library:

git clone
cd deltachat-core-rust
cargo build -p deltachat_ffi --release

This will result in a and libdeltachat.a files in the target/release directory. These files are needed for creating the python bindings for deltachat:

cd python
DCC_RS_DEV=`pwd`/.. pip install -e .

Now test if the bindings find the correct library:

python -c 'import deltachat ; print(deltachat.__version__)'

This should print your deltachat bindings version.


If you can help to automate the building of wheels for Mac or Windows, that’d be much appreciated! please then get in contact with us.

Using a system-installed deltachat-core-rust

When calling pip without specifying the DCC_RS_DEV environment variable cffi will try to use a deltachat.h from a system location like /usr/local/include and will try to dynamically link against a in a similar location (e.g. /usr/local/lib).

Code examples

You may look at examples.

Running tests

Get a checkout of the deltachat-core-rust github repository and type:

pip install tox

If you want to run functional tests with real e-mail test accounts, generate a “liveconfig” file where each lines contains test account settings, for example:

# 'liveconfig' file specifying imap/smtp accounts mail_pw=password mail_pw=otherpassword

The “keyword=value” style allows to specify any deltachat account config setting so you can also specify smtp or imap servers, ports, ssl modes etc. Typically DC’s automatic configuration allows to not specify these settings.

The script will automatically use python/liveconfig if it exists, to manually run tests with this liveconfig file use:

tox -- --liveconfig liveconfig

Running test using a debug build

If you need to examine e.g. a coredump you may want to run the tests using a debug build:

DCC_RS_TARGET=debug ./ -e py37 -- -x -v -k failing_test

Building manylinux1 wheels

Building portable manylinux1 wheels which come with and all it’s dependencies is easy using the provided docker tooling.

using docker pull / premade images

We publish a build environment under the deltachat/wheel tag so that you can pull it from the site’s “deltachat” organization:

$ docker pull deltachat/wheel

The deltachat/wheel image can be used to build both and the Python wheels:

$ docker run --rm -it -v $(pwd):/io/ deltachat/wheel /io/python/wheelbuilder/

This command runs a script within the image, after mounting $(pwd) as /io within the docker image. The script is specified as a path within the docker image’s filesystem. The resulting wheel files will be in python/wheelhouse.

Optionally build your own docker image

If you want to build your own custom docker image you can do this:

$ cd deltachat-core # cd to deltachat-core checkout directory
$ docker build -t deltachat/wheel python/wheelbuilder/

This will use the python/wheelbuilder/Dockerfile to build up docker image called deltachat/wheel. You can afterwards find it with:

$ docker images


On more recent systems running the docker image may crash. You can fix this by adding vsyscall=emulate to the Linux kernel boot arguments commandline. E.g. on Debian you’d add this to GRUB_CMDLINE_LINUX_DEFAULT in /etc/default/grub.

Project details

Download files

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

Files for deltachat, version 0.600.0
Filename, size File type Python version Upload date Hashes
Filename, size deltachat-0.600.0-cp27-cp27m-manylinux1_x86_64.whl (9.4 MB) File type Wheel Python version 2.7 Upload date Hashes View
Filename, size deltachat-0.600.0-cp35-cp35m-manylinux1_x86_64.whl (9.3 MB) File type Wheel Python version 3.5 Upload date Hashes View
Filename, size deltachat-0.600.0-cp36-cp36m-manylinux1_x86_64.whl (9.3 MB) File type Wheel Python version 3.6 Upload date Hashes View
Filename, size deltachat-0.600.0-cp37-cp37m-manylinux1_x86_64.whl (9.3 MB) File type Wheel Python version 3.7 Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page