Skip to main content

An ephemeral nym GUI client

Project description


nymphemeral is a tool made for users searching for secure and anonymous communication on the internet.

It is a GUI client that relies on a pseudonymous remailer that communicates to its users by posting messages to a shared mailbox, a Zax-type nym server. Both the server and the client apply an ephemeral encryption layer on their messages based on the Axolotl Ratchet protocol, providing forward and future secrecy to the conversation.


  • Manages pseudonymous actions: creation, configuration and deletion, as well as message dispatch and retrieval

  • Communicates with the new nymserv, a Zax-type nym server with forward and future secrecy

  • Uses python-gnupg and pyaxo for encryption

  • Uses aampy to retrieve messages from alt.anonymous.messages

  • Sends messages through Mixmaster, sendmail, or outputs the resulting ciphertexts to be sent manually

  • Supports End-to-End Encryption

Current Release

The current version of nymphemeral is 1.4, a beta, released 2015-12-19.

Quick Install

Make sure that you have the following:

sudo apt-get install python-dev python-tk # If using Debian/Ubuntu
sudo yum install python-devel tkinter # If using Fedora

If you use pip, you can easily install nymphemeral with:

sudo pip install nymphemeral

You should at least read news server to make sure you have one running and configured so that your nyms can receive messages.


If you installed nymphemeral with pip, you can also use it for updates:

sudo pip install --upgrade nymphemeral


You can find installation and usage instructions (with screenshots) on the documentation, as well as nymphemeral’s limitations.

Protocol Update

nymphemeral 1.3.3 was updated to use pyaxo 0.4 that follows the latest (Oct 1, 2014) version of the protocol, which changed the order of the ratcheting. For that reason, old conversations (created with nymphemeral < 1.3.3) might not work properly after the update. We suggest that users update nymphemeral and restart their conversations by changing their nyms’ ephemeral keys. The Configuring the Nym section explains how that can be done.


Please report any suggestions, feature requests, bug reports, or annoyances to the GitHub issue tracker.


  • Thanks to rxcomm for the new nymserv,, pyaxo, aampy and for assisting on the development of this client

  • Thanks to crooks (Zax) for the original nymserv software

  • Thanks to tych0 for assisting on fixes and improvements

  • Thanks to HulaHoopWhonix (from the Whonix team) for testing and providing awesome feedback, such as bug reports, feature requests and suggestions

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

nymphemeral-1.4.tar.gz (2.4 MB view hashes)

Uploaded Source

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