Skip to content

README.rst

Latest commit

 

History

History
54 lines (36 loc) · 1.74 KB

README.rst

File metadata and controls

54 lines (36 loc) · 1.74 KB

OL Open edX AI Static Translations

An Open edX plugin that provides AI-powered static translation management. It syncs translation keys, translates them using LLM providers, and creates pull requests with translated content.

Purpose

This plugin provides the sync_and_translate_language management command for syncing and translating Open edX static strings (frontend JSON and backend PO files) using LLM providers (OpenAI, Gemini, Mistral) with optional glossary support.

Setup

For detailed installation instructions, please refer to the plugin installation guide.

Installation required in:

  • Studio (CMS)

Configuration

This plugin shares settings with ol_openedx_course_translations. Ensure the following settings are configured:

TRANSLATIONS_PROVIDERS: {
    "default_provider": "mistral",
    "openai": {"api_key": "", "default_model": "gpt-5.2"},
    "gemini": {"api_key": "", "default_model": "gemini-3-pro-preview"},
    "mistral": {"api_key": "", "default_model": "mistral-large-latest"},
}
TRANSLATIONS_GITHUB_TOKEN: <YOUR_GITHUB_TOKEN>
TRANSLATIONS_REPO_PATH: ""
TRANSLATIONS_REPO_URL: "https://github.com/mitodl/mitxonline-translations.git"

Usage

# Sync and translate a language
./manage.py cms sync_and_translate_language el

# With specific provider and model
./manage.py cms sync_and_translate_language el --provider openai --model gpt-5.2 --glossary /path/to/glossary

License

The code in this repository is licensed under the BSD 3-Clause license unless otherwise noted.

Please see LICENSE.txt for details.