ospo / module-ollama
Schickt KI-Anfragen von Mage-OS-Modulen, die nur OpenAI kennen, an einen eigenen Ollama-Server (Produkttexte, Mago und andere Module auf MageOS_AiBase)
Package info
codeberg.org/OSPO/magento2-module-ollama
Type:magento2-module
pkg:composer/ospo/module-ollama
Requires
- php: ~8.3.0||~8.4.0
- mage-os/module-ai-base: ^1.1
- mage-os/module-catalog-data-ai: dev-main
- magento/framework: *
- magento/module-config: *
- symfony/http-client: ^7.3 || ^8.0
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Schickt KI-Anfragen von Mage-OS-Modulen, die nur die OpenAI-API kennen, stattdessen an einen eigenen Ollama-Server. Die Daten des Shops verlassen damit nicht den eigenen Server, und es fällt keine Gebühr je Anfrage an.
Was das Modul tut
Unterstützt werden:
- Produkttexte aus
mage-os/module-catalog-data-ai(MageOS_CatalogDataAI), - der Admin-Assistent Mago und andere Module auf
mage-os/module-ai-base(ab Mage-OS 4.0.0).
Produkttexte: MageOS_CatalogDataAI holt seine Texte über die Schnittstelle MageOS\CatalogDataAI\Api\AiClientInterface. Das Modul setzt dafür einen eigenen Client ein, der bei eingeschaltetem Ollama die Chat-API von Ollama nutzt und sonst an den OpenAI-Client des Moduls weiterreicht. Ein zweites Plugin erlaubt das automatische Füllen neuer Produkte auch ohne OpenAI-Schlüssel. Die Schnittstelle gibt es erst im Entwicklungsstand von mage-os/module-catalog-data-ai (dev-main, ab April 2026), das letzte Release 1.0.0 vom März 2025 hat sie nicht. Der Stand muss deshalb fest auf einen Commit gepinnt werden, z. B. composer require "mage-os/module-catalog-data-ai:dev-main#4a44952ef0e830ed1088f047e4195bdfc4c1b600".
Mago und andere Module auf MageOS_AiBase (ab 1.2.0): Mage-OS 4 bringt mit mage-os/module-ai-base eine gemeinsame KI-Anbindung mit, auf der der Admin-Assistent Mago aufsetzt. Ollama wird dort als Dienst eingetragen (Shops -> Konfiguration -> Mage-OS -> AI Configuration) und braucht die Bridge symfony/ai-ollama-platform (MIT). Dieses Modul ergänzt drei Dinge, die ab Werk fehlen:
- Kontextlänge: Ohne Angabe nimmt Ollama 4096 Token. Mago schickt mit der ersten Frage etwa 14.000 Token (Systemprompt und 23 Werkzeugbeschreibungen), der Rest würde abgeschnitten. Das Modul setzt
num_ctx(Standard 32768). - Zeitlimit: MageOS_AiBase erzeugt seinen HTTP-Client ohne eigenes Zeitlimit, damit bricht PHP nach 60 Sekunden ohne Daten ab. Ein lokales Modell ohne Grafikkarte liest einen Prompt dieser Länge in mehreren Minuten ein. Das Modul gibt MageOS_AiBase einen Client mit dem Zeitlimit aus
ospo_ollama/general/timeout. - Denkmodus: abschaltbar (
think: false). Ab Werk bleibt er an: Ohne Nachdenken hat qwen3 im Test die Frage nach Bestellungen und Umsatz beantwortet, ohne ein Werkzeug aufzurufen, und die Zahlen erfunden.
Alle drei gelten für jeden Ollama-Dienst in MageOS_AiBase, unabhängig vom Schalter ospo_ollama/general/enabled.
Sitzungswarnung im Backend (ab 1.4.0): Mage-OS bringt Aligent_Pci4Compatibility mit, das 60 Sekunden vor Ablauf der Admin-Sitzung warnt. Den Countdown setzt es nur bei jQuery-AJAX zurück. Mago schickt seine Anfragen mit fetch(), der Server verlängert die Sitzung dabei, der Countdown aber nicht. Wer länger nur mit Mago arbeitet, sah deshalb die Warnung, obwohl die Sitzung noch gültig war. Das Modul setzt nach jeder erfolgreichen fetch()-Anfrage ins Backend den Ablaufzeitpunkt neu (view/adminhtml/web/js/fetch-session-sync.js). Das gilt unabhängig von Ollama für jedes Modul, das fetch() nutzt.
Konfiguration
Im Backend unter Shops -> Konfiguration -> OSPO -> Lokale KI (Ollama), nur im Standardbereich.
| Pfad | Standard | Bedeutung |
|---|---|---|
ospo_ollama/general/enabled | 0 | Anfragen an Ollama statt an OpenAI schicken |
ospo_ollama/general/url | http://ollama-ollama-1:11434 | Adresse der Ollama-API aus Sicht des PHP-Containers |
ospo_ollama/general/model | qwen3.6:35b-a3b | Modellname wie in ollama list |
ospo_ollama/general/timeout | 600 | Zeitlimit in Sekunden, auch für MageOS_AiBase |
ospo_ollama/ai_base/think | 1 | Nachdenken für Ollama-Dienste in MageOS_AiBase erlauben |
ospo_ollama/ai_base/context_length | 32768 | Kontextlänge für Ollama-Dienste in MageOS_AiBase, 0 lässt die Einstellung von Ollama |
Bis 1.2.0 hat das Modul auch die KI-Erzeugung der llms.txt aus mage-os/module-llm-txt umgeleitet. Seit Mage-OS 4.0.0 erzeugt MageOS_Aeo die llms.txt aus den Shopdaten ohne KI, deshalb ist dieser Teil in 1.3.0 entfallen.
Der PHP-Container und der Container, in dem der Cron läuft, müssen Ollama erreichen können, bei Docker Compose also im selben Netz hängen. Die Produkttexte entstehen in einem Queue-Consumer (mageosEnrichProductProcessor), den der Cron startet. Prüfen mit curl http://<ollama>:11434/api/version im PHP-Container.
Produkttexte erzeugen
- Unter
Shops->Konfiguration->Katalog->AI Data Enrichmentdas Modul einschalten, unterProduct Fields Auto-Generationje Attribut einen Prompt anlegen (Platzhalter wie{{name}}oder{{description}}) und unterAdvanced Settingseinen System-Prompt setzen. Die Standard-Prompts des Moduls sind englisch und erzeugen englische Texte. - In
Katalog->ProdukteArtikel markieren und die MassenaktionAI Enrich(Safe)(füllt nur leere Felder) oderAI Enrich(überschreibt) wählen. - Der Cron arbeitet die Warteschlange ab, je Feld etwa 20 Sekunden. Mit eingeschaltetem
Approval Workflowstehen die Texte danach unterKatalog->AI Enrichment Reviewund werden erst nach Freigabe in den Artikel übernommen.
Installation
composer require "mage-os/module-catalog-data-ai:dev-main#4a44952ef0e830ed1088f047e4195bdfc4c1b600"
composer require symfony/ai-ollama-platform:^0.15 # nur für Mago und andere Module auf MageOS_AiBase
composer require ospo/module-ollama
bin/magento module:enable Ospo_Ollama
bin/magento setup:upgrade
bin/magento config:set ospo_ollama/general/enabled 1
Im Production-Modus danach bin/magento setup:di:compile und bin/magento setup:static-content:deploy.
Lizenz: OSL-3.0, wie Magento Open Source und Mage-OS.