Skip to main content

Python module and tools for communicating in the Assuan protocol.

Project description

Python module and tools for communicating in the Assuan protocol.

There are a number of GnuPG wrappers for python out there, but they mostly work via the gpg executable. This is an attempt to cut to the chase and speak directly to gpgme-tool (source) over a well-defined socket protocol.




I’ve packaged pyassuan for Gentoo. You need layman and my wtk overlay. Install with:

# emerge -av app-portage/layman
# layman --add wtk
# emerge -av dev-python/pyassuan


pyassuan is a simple package with no external dependencies outside the Python 3 standard library.

Installing by hand

pyassuan is available as a Git repository:

$ git clone git://

See the homepage for details. To install the checkout, run the standard:

$ python install


Checkout the docstrings and the examples in bin.


Run the internal unit tests using nose:

$ nosetests --with-doctest --doctest-tests pyassuan

If a Python-3-version of nosetests is not the default on your system, you may need to try something like:

$ nosetests-3.2 --with-doctest --doctest-tests pyassuan

To test running servers by hand, you can use gpg-connect-agent. Despite the name, this program can connect to any Assuan server:

$ gpg-connect-agent --raw-socket name


This project is distributed under the GNU General Public License Version 3 or greater.


W. Trevor King

Project details

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page