Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A Django forum engine for building powerful community driven websites.

Project Description

This application is in heavy development. It is not yet suitable for 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 setting to limit the length of topic posts
  • 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.

Release History

History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


This version
History Node


Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting