.. raw:: html

<p align="center">
    <img
    src="docs/_images/logo.svg"
    width="125px;">
</p>
<h1 align="center">django-machina</h1>
<p align="center">
    A Django forum engine for building powerful community driven websites.
</p>
<p align="center">
    <a href="https://django-machina.readthedocs.org/en/stable/" rel="nofollow"><img alt="Documentation Status" src="https://readthedocs.org/projects/django-machina/badge/?version=stable" style="max-width:100%;"></a>
    <a href="https://pypi.python.org/pypi/django-machina/" rel="nofollow"><img alt="License" src="https://img.shields.io/pypi/l/django-machina.svg" style="max-width:100%;">
    </a>
    <a href="https://pypi.python.org/pypi/django-machina" rel="nofollow"><img src="https://img.shields.io/pypi/pyversions/django-machina.svg" style="max-width:100%;"></a>
    <a href="https://pypi.python.org/pypi/django-machina/" rel="nofollow"><img alt="Latest Version" src="https://img.shields.io/pypi/v/django-machina.svg" style="max-width:100%;"></a>
    <a href="https://github.com/ellmetha/django-machina/actions" rel="nofollow"><img alt="Build status" src="https://github.com/ellmetha/django-machina/workflows/CI/badge.svg?branch=master&event=push" style="max-width:100%;"></a>
    <a href="https://codecov.io/github/ellmetha/django-machina" rel="nofollow"><img alt="Codecov status" src="https://codecov.io/gh/ellmetha/django-machina/branch/master/graph/badge.svg" style="max-width:100%;"></a>
</p>

| |

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
• Forum conversations search
• ...

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.

.. contents:: Table of Contents :local:

Documentation

Online browsable documentation is available at https://django-machina.readthedocs.org.

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.

Requirements

Python 3.5+, Django 2.2+. Please refer to the requirements_ section of the documentation for a full list of dependencies.

.. _requirements: https://django-machina.readthedocs.org/en/stable/getting_started.html#requirements

Demo site

A demo site can be tested at https://demo.machina-forum.io. It contains a standard installation of django-machina without any customizations.

Authors

Morgan Aubert (@ellmetha <https://github.com/ellmetha>) and contributors. See AUTHORS for more details.

.. _contributors: https://github.com/ellmetha/django-machina/contributors

License

BSD. See LICENSE for more details.