Ephemeral pseudonym client

nymphemeral, ephemeral, nymserver, GUI, client
pip install nymphemeral==



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 pseudonym 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 pseudonym 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.2, a beta, released 2016-03-21.

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 and setuptools (probably installed automatically with 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.

Feedback and Contact

Please use the GitHub issue tracker to leave suggestions, feature requests, bug reports, complaints or any contribution to nymphemeral. If you feel the need to talk about something else, send messages to nymphemeral@nym.now.im. You can also use its public key for end-to-end encryption.


  • Thanks to rxcomm for the new nymserv, nym.now.im, 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