The aim of federation is to provide and abstract multiple social web protocols like ActivityPub and Diaspora in one package, over an easy to use and understand Python API. This way applications can be built to (almost) transparently support many protocols without the app builder having to know everything about those protocols.



Currently three protocols are being focused on.

  • Diaspora is considered to be stable with most of the protocol implemented.

  • ActivityPub support should be considered as beta - inbound payload are handled by a jsonld processor (calamus)

  • Matrix support cannot be considered usable as of yet.

The code base is well tested and in use in several projects. Backward incompatible changes will be clearly documented in changelog entries.

Additional information

Installation and requirements

See installation documentation.

Usage and API documentation

See usage documentation.

Support and help

See development and support documentation.


BSD 3-clause license.


Jason Robinson / / / GitLab / GitHub