PHPackages                             juhe-it-solutions/contao-openai-assistant - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. juhe-it-solutions/contao-openai-assistant

ActiveContao-bundle[Utility & Helpers](/categories/utility)

juhe-it-solutions/contao-openai-assistant
=========================================

OpenAI Responses API integration for Contao CMS

v2.1.4(4w ago)1363[2 issues](https://github.com/juhe-it-solutions/contao-openai-assistant/issues)LGPL-3.0-or-later AND proprietaryPHPPHP ^8.2CI passing

Since Jul 3Pushed 1w ago1 watchersCompare

[ Source](https://github.com/juhe-it-solutions/contao-openai-assistant)[ Packagist](https://packagist.org/packages/juhe-it-solutions/contao-openai-assistant)[ Docs](https://www.juhe-it-solutions.at)[ RSS](/packages/juhe-it-solutions-contao-openai-assistant/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (10)Dependencies (23)Versions (24)Used By (0)

Contao OpenAI Assistant
=======================

[](#contao-openai-assistant)

 [![JUHE Licenses](public/images/logo_juhe-licenses.svg)](public/images/logo_juhe-licenses.svg)

[![License: LGPL-3.0-or-later AND Proprietary](https://camo.githubusercontent.com/a5850196aeb724f1b47f6bace00c8ba4c6d7197ddb91f6190039209ce16d04a1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4c47504c253230332e302d2d6f722d2d6c61746572253230414e4425323050726f70726965746172792d626c75652e737667)](LICENSE)[![Contao](https://camo.githubusercontent.com/95181d6c879365775c6c6d19729c12a654d3a7ba59626a392392269f0da681cf/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e74616f2d352e332b2d677265656e2e737667)](https://contao.org)[![PHP](https://camo.githubusercontent.com/26bf6e41ce21eb39db7d8ace00cc112ed5be5e9d8fbd657254521fcea77983b9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322b2d707572706c652e737667)](https://php.net)[![Packagist](https://camo.githubusercontent.com/f6db8b2a5449b2b889e882ec7e7a67af347e37ddc1c3286eb56f6742df0f5820/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6a7568652d69742d736f6c7574696f6e732f636f6e74616f2d6f70656e61692d617373697374616e742e737667)](https://packagist.org/packages/juhe-it-solutions/contao-openai-assistant)

OpenAI Responses API integration for Contao 5.3+. The extension adds a backend dashboard for OpenAI configuration, prompt setup and knowledge-base files, plus a configurable frontend AI chatbot module.

It uses OpenAI's Responses API and Conversations API at runtime. Knowledge-base files are uploaded to OpenAI vector stores and attached through File Search.

> **Upgrading from 1.x?** Version 2.0 is a breaking change: the extension no longer calls the OpenAI Assistants API (`/v1/assistants`, `/v1/threads`). Any OpenAI Assistants created by older versions are cleaned up from the OpenAI platform by a one-shot migration on upgrade. See the [CHANGELOG](https://github.com/juhe-it-solutions/contao-openai-assistant/blob/main/CHANGELOG.md) and [Upgrading from 1.x](https://github.com/juhe-it-solutions/contao-openai-assistant/blob/main/docs/development/troubleshooting.md#upgrading-from-1x).

Requirements
------------

[](#requirements)

- Contao 5.3 or newer
- PHP 8.2 or newer
- OpenAI API key with access to Responses, Conversations, Files and Vector Stores

Installation
------------

[](#installation)

Install with Contao Manager or Composer:

```
composer require juhe-it-solutions/contao-openai-assistant
```

Then run the Contao database migration. Detailed setup is documented in [`docs/installation.md`](https://github.com/juhe-it-solutions/contao-openai-assistant/blob/main/docs/installation.md).

Automatic Vector-Store Sync (Premium Add-On)
--------------------------------------------

[](#automatic-vector-store-sync-premium-add-on)

> **Keep your chatbot knowledge base up to date automatically.**
>
> The premium add-on can crawl selected Contao pages and update the OpenAI vector store from your website content. It supports manual or scheduled runs and requires a valid premium license.
>
> Learn more in the [premium add-on help pages](https://licenses.juhe-it-solutions.at/en/openai-assistant/help).

Documentation
-------------

[](#documentation)

- [`docs/README.md`](https://github.com/juhe-it-solutions/contao-openai-assistant/blob/main/docs/README.md) - documentation index
- [`docs/installation.md`](https://github.com/juhe-it-solutions/contao-openai-assistant/blob/main/docs/installation.md) - installation and first setup
- [`docs/configuration/openai-setup.md`](https://github.com/juhe-it-solutions/contao-openai-assistant/blob/main/docs/configuration/openai-setup.md) - OpenAI configuration
- [`docs/configuration/prompts.md`](https://github.com/juhe-it-solutions/contao-openai-assistant/blob/main/docs/configuration/prompts.md) - prompt configuration
- [`docs/development/troubleshooting.md`](https://github.com/juhe-it-solutions/contao-openai-assistant/blob/main/docs/development/troubleshooting.md) - upgrade notes and common issues

License And Security
--------------------

[](#license-and-security)

This extension is dual-licensed:

- **Core extension** (backend dashboard, prompts, knowledge-base files, frontend chatbot): LGPL-3.0-or-later, see [`LICENSE`](LICENSE).
- **Premium add-on** (automatic vector-store sync and license validation; the files listed in [`LICENSE-PREMIUM`](LICENSE-PREMIUM)): proprietary. The files ship with the package, but using the premium features requires a valid [premium subscription](https://licenses.juhe-it-solutions.at).

Versions tagged before the introduction of `LICENSE-PREMIUM` remain entirely under LGPL-3.0-or-later.

Please report security issues privately to .

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance76

Regular maintenance activity

Popularity18

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 50% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~19 days

Recently: every ~1 days

Total

21

Last Release

29d ago

Major Versions

v1.1.3 → v2.0.02026-05-21

PHP version history (2 changes)1.0.0PHP >=8.1

v1.0.3PHP ^8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/60215157?v=4)[Jürgen Herrnegger](/maintainers/jochi44)[@jochi44](https://github.com/jochi44)

---

Top Contributors

[![jochi44](https://avatars.githubusercontent.com/u/60215157?v=4)](https://github.com/jochi44 "jochi44 (2 commits)")[![zoglo](https://avatars.githubusercontent.com/u/55794780?v=4)](https://github.com/zoglo "zoglo (2 commits)")

---

Tags

chatbotcontaocontao-extensionopenaiaiopenaicontaochatbotassistant

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleECS

Type Coverage Yes

### Embed Badge

![Health badge](/badges/juhe-it-solutions-contao-openai-assistant/health.svg)

```
[![Health](https://phpackages.com/badges/juhe-it-solutions-contao-openai-assistant/health.svg)](https://phpackages.com/packages/juhe-it-solutions-contao-openai-assistant)
```

###  Alternatives

[kimai/kimai

Kimai - Time Tracking

4.8k9.4k1](/packages/kimai-kimai)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.8M676](/packages/shopware-core)[markocupic/calendar-event-booking-bundle

Contao Calendar Event Booking Bundle

125.3k1](/packages/markocupic-calendar-event-booking-bundle)[chameleon-system/chameleon-base

The Chameleon System core.

1029.4k6](/packages/chameleon-system-chameleon-base)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)