django-traduire 0.1.0

Auto-translate django-modeltranslation fields using DeepL, Google, or OpenAI

django-traduire

Documentation | PyPI | GitHub

Auto-translate django-modeltranslation fields using DeepL, Google Cloud Translation, or OpenAI.

Fill in content in one language, and django-traduire populates all the other language columns automatically.

Install

pip install django-traduire[deepl]    # DeepL backend
pip install django-traduire[google]   # Google Cloud Translation
pip install django-traduire[openai]   # OpenAI / LLM backend
pip install django-traduire[all]      # All backends

Quick start

# settings.py
INSTALLED_APPS = [
    ...
    "modeltranslation",
    "django_traduire",
]

LANGUAGES = [
    ("fr", "Francais"),
    ("de", "Deutsch"),
    ("en", "English"),
    ("it", "Italiano"),
]

TRADUIRE = {
    "BACKEND": "django_traduire.backends.deepl.DeepLBackend",
    "SOURCE_LANGUAGE": "fr",
    "BACKEND_OPTIONS": {
        "auth_key": "your-deepl-api-key",
    },
}

Translate in Python

from django_traduire import translate_instance

article = Article.objects.get(pk=1)
# article.title_fr = "Bonjour le monde"

translate_instance(article)
# article.title_de = "Hallo Welt"
# article.title_en = "Hello world"
# article.title_it = "Ciao mondo"

Management command

# Translate all registered models
python manage.py traduire

# Translate a specific model
python manage.py traduire myapp.Article

# Overwrite existing translations
python manage.py traduire --overwrite

# Dry run
python manage.py traduire --dry-run

Admin integration

from django.contrib import admin
from modeltranslation.admin import TranslationAdmin
from django_traduire.admin import TraduireMixin

@admin.register(Article)
class ArticleAdmin(TraduireMixin, TranslationAdmin):
    pass

This adds "Translate empty fields" and "Translate all fields (overwrite)" actions to the admin.

Auto-translate on save

TRADUIRE = {
    ...
    "AUTO_TRANSLATE": True,
}

Every time a model is saved, empty translation fields are filled automatically.

Backends

Backend	Install	Best for
DeepL	pip install django-traduire[deepl]	European languages, highest quality
Google Cloud	pip install django-traduire[google]	Broadest language coverage
OpenAI	pip install django-traduire[openai]	Creative / contextual translations

License

MIT - Paul Guindo / Altius Academy SNC.