Extendware Ollama AI Translator – Magento 2 Extension

A privacy-focused, on-premise translation solution for Magento 2 that leverages Ollama AI models to translate products, categories, and CMS content — without sending any data to external services.

All translations are processed securely on your own infrastructure, ensuring compliance with strict data privacy and security requirements.

Supports integration with advanced AI models (like Gemma3-Translator and Qwen2.5-Translator) for high-quality multilingual translations, with no reliance on cloud APIs.

Extendware’s Ollama AI Translator includes:

  • Ollama AI Translation: All translation processing happens on your own machine

  • Privacy-First: No data leaves your network

  • Multiple Models: Support for Gemma3-Translator and Qwen2.5-Translator

  • Automatic Translation: Translates product attributes on save

  • Batch Processing: CLI commands for bulk translation

  • Configurable: Full admin configuration with attribute selection

Please notice, that the extension requires a 4GB+ RAM and 10GB+ disk space for optimal performance.

Interested in Extension Installation Service?

Visit our installation service page https://www.extendware.com/magento-extension-installation-service.html for more information

Support

Got questions? Feel free to contact us! Support Form.

Installation Procedure

Type 1: Zip file

  • Download your extension package from the Download page after purchasing the extension.

  • Open the extension ZIP file you downloaded and extract it to a directory on your computer using a tool like WinRar, WinZIP or similar.

  • Upload the extracted files to the app/code/Extendware directory in your Magento installation, maintaining the folder structure. If updating, overwrite the existing files.

  • Connect via SSH and run the following commands (make sure to run them as the user who owns the Magento files!

    php bin/magento module:enable --clear-static-content Extendware_Core

php bin/magento module:enable --clear-static-content Extendware_OllamaAITranslator

php bin/magento setup:upgrade

php bin/magento setup:di:compile

php bin/magento setup:static-content:deploy

User Guide

We highly recommend gathering all the below information, before starting the installation.

Requirements & Recommendations

Before using Extendware’s Ollama AI Translator, make sure your environment meets the following requirements:

  • No Subscription Needed:
    The Ollama AI Translator does not rely on any paid API or external cloud service.
    All translations are processed locally through your self-hosted Ollama instance.

  • Ollama Server Setup:
    A running Ollama server is required to process translation requests.
    By default, Ollama listens on port 11434 — make sure this port is open and accessible on your machine or network.
    Example endpoint: http://localhost:11434

  • System Resources:
    We recommend at least 4 GB RAM and 10 GB disk space for optimal performance.
    GPU acceleration (if available) can significantly improve translation speed.

  • Tested Models:
    Extendware has verified compatibility and translation quality with the following models:

    • zongwei/gemma3-translator:4b

    • lauchacarro/qwen2.5-translator:latest
      You may experiment with other Ollama translation models from the Ollama Model Library.

  • Official Ollama Installation Guide:
    For detailed installation and setup steps, please refer to the Ollama official documentation or the GitHub repository.
    The installation process may vary depending on your system configuration (CPU-only, GPU, or remote hosting).

  • Future Hosting Option (Optional):
    Extendware is evaluating the possibility of offering dedicated Ollama hosting for merchants who prefer managed environments.
    If you’re interested in a managed Ollama setup or hosting assistance, feel free to reach out to us via our Support Form.

Configuration

To configure the extension, go to Dashboard → Stores → Configuration → Extendware Menu → Ollama AI Translator → Configuration

alt_text

Configuration Overview

  • Enable Ollama AI Translator Integration → Toggle the extension on or off.

  • Ollama Host URL → Enter your local Ollama API endpoint (e.g., http://localhost:11434).

  • Primary Translation Model → Select the default Ollama model for translations.

  • Fallback Translation Model → Backup model used if the primary fails or produces invalid output.

  • Ollama API Mode → Choose between Chat API and Generate API for translation requests.

    • Chat API: Provides conversational, context-aware translations — best for CMS pages, blocks, and descriptive product text.

    • Generate API: Produces concise, literal translations — ideal for short product attributes or structured data.
      This setting controls how translation requests are sent to the selected Ollama model.

  • Custom Translation Prompt → Define your own translation prompt template.

    • You can customize the phrasing around placeholders like {source_lang} and {target_lang} to change the translation tone or style.

    • Example: Translate from {source_lang} to {target_lang} in a friendly and natural tone.

    • Important: Do not remove or rename the placeholders {source_lang} and {target_lang} — they are automatically replaced with the correct language codes during translation.

  • Test Connection → Check connectivity with your local Ollama service.

  • Translate Source → Choose the source store/language for translations.

  • Product Attributes To Translate → Select product attributes for automatic translation.

  • CMS Page Attributes To Translate → Select which CMS page fields to translate.

  • Block Attributes To Translate → Select which CMS block fields to translate.

  • Category Attributes To Translate → Select which category fields to translate.

alt_text

alt_text

alt_text

Product Translation

1. Translate using single product mode:

  • With this user can see button to do AI translate and can select specific store for translation.

  • Please note that the source store will only be set in the system configuration of the Ollama AI Translator module.

alt_text

Before Translation

alt_text

After Translation

alt_text

2. Translate using CommandLine

 php bin/magento extendware_ollamaaitranslator:translateproduct  -r1-2 -s2 (without message queue)

  • Where [r] represent product range user can define range with product id like 1-20

  • Where [s] represent store id

php bin/magento extendware_ollamaaitranslator:translateproduct -r1-2 -s2 -m[username_of_admin]

  • Where [r] represent product range user can define range with product id like 1-20

  • Where [s] represent store id

  • Where [m] represent the username of admin where you can find queue from system->action logs

Category Translate:

1. Category Translate using single category backend

  • With this user can see button to do AI translate and can select specific store for translation.

  • Please note that the source store will only be set in the system configuration of the Ollama AI Translate module.

alt_text

2. Translate using CommandLine

 php bin/magento extendware_ollamaaitranslator:translatecategory  -r1-2 -s2 (without message queue)

  • Where [r] represent category range user can define range with category id like 1-20

  • Where [s] represent store id

php bin/magento extendware_ollamaaitranslator:translatecategory -r1-2 -s2 -m[username_of_admin]

  • Where [r] represent category range user can define range with category id like 1-20

  • Where [s] represent store id

  • Where [m] represent the username of admin where you can find queue from system->action logs

Page Translate:

1. Page Translate using single page backend

  • With this user can see button to do AI translate and can select specific store for translation.

  • Please note that the source store will only be set in the system configuration of the Ollama AI Translator module.

  • If URL key exist for DE store then it will throw error as page for DE store is already there

  • This will also remove DE store ID from main page

  • For example there is a page which is assigned to all stores and if user click on translate for DE store then if translation is successful then user can see new page with only DE store assign and in main page DE store was removed.

alt_text

2. Translate using CommandLine

 php bin/magento extendware_ollamaaitranslator:translatepage  -r1-2 -s2 (without message queue)

  • Where [r] represent page range user can define range with page id like 1-20

  • Where [s] represent store id

php bin/magento extendware_ollamaaitranslator:translatepage -r1-2 -s2 -m[username_of_admin]

  • Where [r] represent page range user can define range with page id like 1-20

  • Where [s] represent store id

  • Where [m] represent the username of admin where you can find queue from system->action logs

Block Translate:

1. Block Translate using single block backend

  • With this user can see button to do AI translate and can select specific store for translation.

  • Please note that the source store will only be set in the system configuration of the Ollama AI Translate module.

alt_text

2. Translate using CommandLine

 php bin/magento extendware_ollamaaitranslator:translateblock  -r1-2 -s2 (without message queue)

  • Where [r] represent block range user can define range with block id like 1-20

  • Where [s] represent store id

php bin/magento extendware_ollamaaitranslator:translateblock -r1-2 -s2 -m[username_of_admin]

  • Where [r] represent block range user can define range with block id like 1-20

  • Where [s] represent store id

  • Where [m] represent the username of admin where you can find queue from system->action logs

Important Notes

  • Ollama-based translation features require Ollama to be installed and running, with appropriate models pulled.

  • HTML translation is best tested on staging environments before live deployment.

  • The extension is designed to work with local AI models for privacy and speed. Ensure your server meets hardware requirements for selected models.

  • Run translation via consumer queue using below command

    bin/magento queue:consumers:start product_action_attribute.translate --max-messages=10000

  • Any translation with message queue admin can check progress from System -> Bulk Actions

    alt_text

Translation Disclaimer

Extendware’s Ollama AI Translator provides a direct interface between Magento and your locally hosted Ollama AI models. The extension itself does not control, modify, or influence translation output in any way. All translation results are generated solely by the selected Ollama model based on your prompt and configuration.

You can freely experiment with different translation models, prompts, and configurations to achieve desired results. The outcome will depend entirely on how the selected model interprets and renders the translation request.

Extendware’s Ollama AI Translator simply transmits your content to the locally hosted model and returns the raw response, ensuring full transparency, neutrality, and data privacy.

Troubleshooting

Check Ollama Service:

curl http://localhost:11434/api/version
ollama list

Common issues:

  • Ollama not running: Restart the service (ollama serve)

  • Model not found: Ensure you have pulled the correct model (ollama pull ...)

  • Endpoint unreachable: Verify your API URL and firewall settings

Changelog

[1.0.0]

  • Initial release.