Homepage | Simple index

A Django forum engine for building powerful community driven websites.

author Morgan Aubert
  • Development Status :: 3 - Alpha
  • Environment :: Web Environment
  • Framework :: Django
  • Intended Audience :: Developers
  • License :: OSI Approved :: BSD License
  • Natural Language :: English
  • Programming Language :: Python
  • Programming Language :: Python :: 2
  • Programming Language :: Python :: 2.7
  • Programming Language :: Python :: 3
  • Programming Language :: Python :: 3.3
  • Programming Language :: Python :: 3.4
  • Programming Language :: Python :: 3.5
license BSD
File Size Python Type Tox results History
2 MB
Uploaded to nephila/dev by nephila 2016-03-05 06:12:12
2 MB
Python Wheel
Uploaded to nephila/dev by nephila 2016-03-05 06:12:30
Documentation Status License Latest Version Build status Codecov status

This application is currently in alpha. It should not be used in production environments.

Django-machina is a forum framework for Django providing a way to build community-driven websites. It offers a full-featured yet very extensible forum solution:

  • Topic and post editing
  • Forums tree management
  • Per-forum permissions
  • Anonymous posting
  • Polls and attachments
  • Moderation and pre-moderation

Django-machina was built with integration in mind: the application is designed to be used inside existing Django applications. It is not a standalone forum solution.

Django-machina was built with customization and extensibility in mind: each single functionality of the application can be customized or overriden to accommodate with your needs. In fact, django-machina uses the same techniques as those introduced by the famous django-oscar e-commerce framework to allow powerfull customizations.


Online browsable documentation is available at

Head over to the documentation for all the details on how to set up your forum and how to customize it to suit your needs.


Python 2.7+ or 3.3+, Django 1.8+. Please refer to the requirements section of the documentation for a full list of dependencies.

Demo sites

Two demo sites can be tested:

  • the vanilla project contains a standard installation of django-machina without customization
  • the demo project showcases the customization possibilities of django-machina


  • Topic subscriptions: a user can get a list of all topics to which he subscribed
  • A view to get all the posts of a forum member
  • A setting to limit the maximum size of an attachment
  • A way to prevent users to submit too many posts in a given period


Morgan Aubert (@ellmetha) and contributors


BSD. See LICENSE for more details.