translatebot-django 0.3.4

Stop copy-pasting to and from Google Translate. Translate your Django .po files automatically with AI.

translatebot-django

Stop copy-pasting to and from Google Translate. Translate your Django .po files automatically with AI.

Documentation: https://translatebot.dev/docs/

The Problem

Maintaining translations in Django is painful:

• Opening .po files, copying to Google Translate, pasting back - repeat 200 times
• Placeholders like %(username)s get mangled and crash your app
• Source strings change, and now you need to update .po files for all 10 languages
• Hours spent on translations instead of building features

The Solution

One command translates everything while preserving your Django placeholders:

python manage.py translate --target-lang fr

Features

• Multiple AI Providers: OpenAI, Anthropic, Google Gemini, Azure, and many more
• Smart Translation: Preserves placeholders (%(name)s, {0}, %s) and HTML tags
• Model Field Translation: Supports django-modeltranslation
• Flexible Configuration: Django settings, environment variables, or CLI arguments
• Well Tested: 100% code coverage

Installation

pip install translatebot-django

Quick Start

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

TRANSLATEBOT_API_KEY = "your-api-key-here"

# Translate to Dutch
python manage.py translate --target-lang nl

# Preview without saving
python manage.py translate --target-lang nl --dry-run

Documentation

For full documentation, visit translatebot.dev/docs/

• Installation
• Configuration
• Command Reference
• Model Translation
• Supported AI Models
• FAQ

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

# Setup
git clone https://github.com/gettranslatebot/translatebot-django.git
cd translatebot-django
uv sync --extra dev

# Run tests
uv run pytest

License

This project is licensed under the Mozilla Public License 2.0 - see the LICENSE file for details.

Credits

• Built with LiteLLM for universal LLM provider support
• Uses polib for .po file manipulation

---

Made with ❤️ for the Django community