<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=main&event=push" 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 local=""} Table of Contents :::

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.6+, Django 3.2+. Please refer to the requirements section of the documentation for a full list of dependencies.

Authors

Morgan Aubert (\@ellmetha) and contributors. See AUTHORS for more details.

License

BSD. See LICENSE for more details.