Search by

ospo / module-ollama

splendidinternet

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

Issues

Type:magento2-module

pkg:composer/ospo/module-ollama

Statistics

Installs: 4

Dependents: 0

Suggesters: 0

1.4.0 2026-11-04 07:52 UTC

This package is auto-updated.

Last update: 2026-11-17 18:55:04 UTC


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.

PfadStandardBedeutung
ospo_ollama/general/enabled0Anfragen an Ollama statt an OpenAI schicken
ospo_ollama/general/urlhttp://ollama-ollama-1:11434Adresse der Ollama-API aus Sicht des PHP-Containers
ospo_ollama/general/modelqwen3.6:35b-a3bModellname wie in ollama list
ospo_ollama/general/timeout600Zeitlimit in Sekunden, auch für MageOS_AiBase
ospo_ollama/ai_base/think1Nachdenken für Ollama-Dienste in MageOS_AiBase erlauben
ospo_ollama/ai_base/context_length32768Kontextlä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

  1. Unter Shops -> Konfiguration -> Katalog -> AI Data Enrichment das Modul einschalten, unter Product Fields Auto-Generation je Attribut einen Prompt anlegen (Platzhalter wie {{name}} oder {{description}}) und unter Advanced Settings einen System-Prompt setzen. Die Standard-Prompts des Moduls sind englisch und erzeugen englische Texte.
  2. In Katalog -> Produkte Artikel markieren und die Massenaktion AI Enrich(Safe) (füllt nur leere Felder) oder AI Enrich (überschreibt) wählen.
  3. Der Cron arbeitet die Warteschlange ab, je Feld etwa 20 Sekunden. Mit eingeschaltetem Approval Workflow stehen die Texte danach unter Katalog -> AI Enrichment Review und 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.