Get started with
Django Baton

INSTALLATION

1. Install from PyPI

$ pip install django-baton

2. Add baton and baton.autodiscover to your INSTALLED_APPS. Notice that baton must be placed before django.contrib.admin and baton.autodiscover must be placed at the very end!

INSTALLED_APPS = [
    # ... 
    'baton',
    'django.contrib.admin',
    # ...
    'baton.autodiscover',
]

3. Run migrations

$ python manage.py migrate

4. Replace django.contrib.admin in your project urls and add baton

from baton.autodiscover import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('baton/', include('baton.urls')),

]

CONFIGURATION

Here we'll see a simple example of configuration which enables AI functionalities, for a full reference of all available options plese visit the repository page

from baton.ai import AIModels

BATON = {
    'SITE_HEADER': 'Baton',
    'SITE_TITLE': 'Baton',
    'COPYRIGHT': 'copyright © 2025 <a href="https://www.otto.to.it">Otto srl</a>', # noqa
    'POWERED_BY': '<a href="https://www.otto.to.it">Otto srl</a>',
    'CONFIRM_UNSAVED_CHANGES': True,
    'SHOW_MULTIPART_UPLOADING': True,
    'ENABLE_IMAGES_PREVIEW': True,
    'CHANGELIST_FILTERS_IN_MODAL': True,
    'CHANGEFORM_FIXED_SUBMIT_ROW': True,
    'BATON_CLIENT_ID': 'xxxxxxxxxxxxxxxxxxxx',
    'BATON_CLIENT_SECRET': 'xxxxxxxxxxxxxxxxxx',
    'AI': {
        "IMAGES_MODEL": AIModels.BATON_DALL_E_3,
        "VISION_MODEL": AIModels.BATON_GPT_4O_MINI,
        "SUMMARIZATIONS_MODEL": AIModels.BATON_GPT_4O_MINI,
        "TRANSLATIONS_MODEL": AIModels.BATON_GPT_4O,
        'ENABLE_TRANSLATIONS': True,
        'ENABLE_CORRECTIONS': True,
        'CORRECTION_SELECTORS': ["textarea", "input[type=text]:not(.vDateField):not([name=username]):not([name*=subject_location])"],
        "CORRECTIONS_MODEL": AIModels.BATON_GPT_3_5_TURBO,
    },
}

You will find the BATON_CLIENT_ID and BATON_CLIENT_SECRET in your personal area after the creation of a subscription key.

View the full documentation.

When signing up you'll receive a welcome bonus of 2€ (no credit card required) in order to let you try the AI functionality.