Skip to content

Installation

Requirements

  • Python 3.10 or higher
  • Django 4.2 or higher

Install with pip

pip install translatebot-django

Install with Poetry

poetry add translatebot-django

Install with uv

uv add translatebot-django

Optional: Model Translation Support

If you want to translate database model fields using django-modeltranslation:

pip install translatebot-django[modeltranslation]

poetry add translatebot-django[modeltranslation]

uv add translatebot-django[modeltranslation]

Add to Django

Add translatebot_django to your INSTALLED_APPS:

settings.py
INSTALLED_APPS = [
    # ...
    'translatebot_django',
]

For Model Translation

If using django-modeltranslation, add it before django.contrib.admin:

settings.py
INSTALLED_APPS = [
    'modeltranslation',  # Must be before admin
    'django.contrib.admin',
    # ...
    'translatebot_django',
]

Next Steps

Continue to the Quick Start Guide to translate your first strings.