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
Type 2: Via Composer (recommended)¶
You can freely install, update, and remove Magento 2 extensions using Composer.
Please request your private access first via Support Form.
Add the custom repository to the composer.json
composer config repositories.private-packagist composer https://extendware.repo.packagist.com/your-company-name/
Setup authentication
composer config --auth http-basic.extendware.repo.packagist.com token YOUR-PRIVATE-TOKEN
Install the module
composer require extendware/module-ollamaaitranslator
run the following commands
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:11434System 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:4blauchacarro/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

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.



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.

Before Translation

After Translation

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.

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.

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.

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

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.