Strapi LLM Translator (Axe Fork)

AI-Powered Content Translation for Strapi

Fork of strapi-llm-translator with additional features for production use.

The Strapi LLM Translator plugin enhances your localization workflow by utilising LLMs to translate your content fields with a single click. Compatible with any OpenAI-compatible LLM, it preserves your original formatting while delivering fast, accurate results in seconds.

What's Different in This Fork

• Batch Translation - Translates fields in batches of 10, avoiding token limits on large content types
• Configurable Model & URL in UI - Change your LLM model and base URL directly from the Strapi admin settings page (no redeployment needed)
• SSE Streaming Responses - Uses Server-Sent Events with heartbeats to keep connections alive during long translations, avoiding timeouts on platforms like Heroku

Key Features

• Multi-field Support - Translates all text-based fields (string, text, richtext) and JSON/Blocks content, including Strapi 5 structured rich text
• LLM Agnostic - Works with any OpenAI-compatible API (your choice of provider or local)
• Format Preservation - Maintains markdown formatting during translation
• Smart UUID Handling - Auto-translates slugs when i18n is enabled with relative fields
• Auto-fill - Instantly populates generated translations
• Customizable - Adjust system prompts and temperature for optimal results

Tested With

• Strapi: v5.12.x, v5.15.x
• LLM Providers:
  • OpenAI: gpt-4o
  • Groq: meta-llama/llama-4-scout-17b-16e-instruct
  • Local: Ollama, e.g. phi4-mini

Installation & Setup

Prerequisites

• Strapi project (v5+)
• API key for your preferred LLM provider, Base Url + Model Name
• Configured internationalization with at least two languages in your Strapi application

Installation

1. Install the plugin in your Strapi project:

npm install strapi-llm-translator-axe

2. Configure environment variables:

# Optional - Your LLM provider API key (Can be left empty if there is no API Key needed)
LLM_TRANSLATOR_LLM_API_KEY=

# Optional - Defaults to OpenAI's endpoint (can also be set in the admin UI)
STRAPI_ADMIN_LLM_TRANSLATOR_LLM_BASE_URL=

# Optional - Defaults to gpt-4o (can also be set in the admin UI)
STRAPI_ADMIN_LLM_TRANSLATOR_LLM_MODEL=

3. Rebuild your admin panel:

npm run build

After installation, customize the translation behavior through the LLM Translator configuration page, where you can also change the model and base URL without redeploying:

Plugin Development

To contribute to the plugin development:

1. Navigate to your Strapi project
2. Add and link the plugin: npx yalc add strapi-llm-translator-axe && npx yalc link strapi-llm-translator-axe && npm install
3. Start your Strapi project
4. In a separate terminal, watch the plugin for changes: npm run watch:link

About

Originally created by Franziska Fieke (grenzbotin) – vulpis.dev

This fork is maintained by Axxoul.

Distributed under the MIT license. See LICENSE for more information.