threema-gateway is a Python 3 module for the Threema gateway service. This API can be used to send and receive text messages to and from any Threema user.

On machines where Python 3 is not the default Python runtime, you should use pip3 instead of pip.

$ sudo apt-get install python3 python3-pip

We recommend using the virtualenv package to create an isolated Python environment:

$ sudo pip install virtualenv
$ virtualenv -p python3 threema-gateway-venv

You can switch into the created virtual environment threema-gateway-venv by running this command:

$ source threema-gateway-venv/bin/activate

To deactivate the virtual environment, just run:

$ deactivate

If you are using a virtual environment, activate it first.

Install the module by running:

$ pip install git+https://github.com/threema-ch/msgapi-sdk-python.git

The dependency libnacl will be installed automatically. However, you may need to install libsodium for libnacl to work.

The file threema-gateway provides a command line interface for the Threema gateway. Run the following command to see usage information:

$ ./threema-gateway --help