Skip to content
An XMPP library for use with Python 3.4+ asyncio.
Branch: devel
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
aioxmpp Merge branch 'hotfix/sm-location-format' into feature/sm-location-format Jul 8, 2019
benchmarks xml: add benchmark for xmlValidateNameValue May 19, 2018
data Add alpha version of XHTML-IM sanitisation XSLT Mar 2, 2017
docs Add changelog entry for hotfix Jul 8, 2019
tests Merge branch 'hotfix/sm-location-format' into feature/sm-location-format Jul 8, 2019
utils pubsub: do not run get_items_by_id e2etest on broken implementations Mar 2, 2019
.coveragerc Exclude from .coveragerc Apr 11, 2017
.gitignore Implement Travis CI <-> integration Apr 4, 2017
.mailmap Add mailmap file for myself Oct 11, 2018
.travis.yml Upgrade build environment to accomodate luasec 0.8 Apr 24, 2019
COPYING.LESSER Write license headers and transition to LGPLv3 Oct 8, 2016
COPYING.gpl3 Fix up the license mess Nov 15, 2015
LICENSES Update LICENSES document May 14, 2017 Add to include license information in sdist tarball May 14, 2017
Makefile Add docs-clean target to top-level makefile May 19, 2016
README.rst Draft security policy May 23, 2019 Draft security policy May 23, 2019 travis: add build for python 3.7 Dec 16, 2018
tox.ini Fix (or silence :)) all the flake8 complaints in the code Mar 2, 2019



... is a pure-python XMPP library using the asyncio standard library module from Python 3.4 (and available as a third-party module to Python 3.3).


  • Native Stream Management (XEP-0198) support for robustness against transient network failures (such as switching between wireless and wired networks).
  • Powerful declarative-style definition of XEP-based and custom protocols. Most of the time, you will not get in contact with raw XML or character data, even when implementing a new protocol.
  • Secure by default: TLS is required by default, as well as certificate validation. Certificate or public key pinning can be used, if needed.
  • Support for RFC 6121 (Instant Messaging and Presence) roster and presence management, along with XEP-0045 (Multi-User Chats) for your human-to-human needs.
  • Support for XEP-0060 (Publish-Subscribe) and XEP-0050 (Ad-Hoc Commands) for your machine-to-machine needs.
  • Several other XEPs, such as XEP-0115 (including native support for the reading and writing the capsdb) and XEP-0131.
  • APIs suitable for both one-shot scripts and long-running multi-account clients.
  • Well-tested and modular codebase: aioxmpp is developed in test-driven style and in addition to that, many modules are automatedly tested against Prosody and ejabberd, two popular XMPP servers.

There is more and there’s yet more to come! Check out the list of supported XEPs in the official documentation and open GitHub issues tagged as enhancement for things which are planned and read on below on how to contribute.


The aioxmpp API is thoroughly documented using Sphinx. Check out the official documentation for a quick start and the API reference.



If you consider contributing to aioxmpp, you can do so, even without a GitHub account. There are several ways to get in touch with the aioxmpp developer(s):

  • The development mailing list. Feel free to subscribe and post, but be polite and adhere to the Netiquette (RFC 1855). Pull requests posted to the mailing list are also welcome!
  • The development MUC at Pull requests announced in the MUC are also welcome! Note that the MUC is set persistent, but nevertheless there may not always be people around. If in doubt, use the mailing list instead.
  • Open or comment on an issue or post a pull request on GitHub.

No idea what to do, but still want to get your hands dirty? Check out the list of 'help wanted' issues on GitHub or ask in the MUC or on the mailing list. The issues tagged as 'help wanted' are usually of narrow scope, aimed at beginners.

Be sure to read the docs/CONTRIBUTING.rst for some hints on how to author your contribution.

Security issues

If you believe that a bug you found in aioxmpp has security implications, you are welcome to notify me privately. To do so, send a mail to Jonas Schäfer, encrypted using the GPG public key 0xE5EDE5AC679E300F (Fingerprint AA5A 78FF 508D 8CF4 F355 F682 E5ED E5AC 679E 300F).

If you prefer to disclose security issues immediately, you can do so at any of the places listed above.

More details can be found in the file.

Change log

The change log is included in the official documentation.

You can’t perform that action at this time.