Skip to content

Installation

Via Composer

composer require netthinks/nt-ai

Activate in Admin Tools → Extensions, or via CLI:

vendor/bin/typo3 extension:setup

The extension creates its database tables (tx_ntai_audit_report, tx_ntai_page_score, tx_ntai_lighthouse_report, tx_ntai_token_usage) on activation. After a manual composer update, run:

vendor/bin/typo3 database:updateschema

Manual installation

  1. Download the latest release from the GitHub releases page.
  2. Extract to typo3conf/ext/nt_ai.
  3. Activate in Admin Tools → Extensions.

After installation

Open Admin Tools → Settings → Extension Configuration → nt_ai and configure at least one AI provider (see Configuration).

Note

Until a provider is configured, the backend modules load but AI-powered features report "no provider configured".

Enabling the accessibility widget & read-aloud in the frontend

The frontend widget and read-aloud are provided as a Site Set. On a customer system you only add the set as a dependency — either in the site configuration or as a dependency of your own sitepackage set:

# config/sites/<identifier>/config.yaml  (or in your own set)
dependencies:
  - netthinks/nt-ai

The settings then appear automatically under Site Management → Settings (categories "Barrierefreiheit" and "Vorlesen (TTS)"). No manual settings.definitions.yaml entries are needed. The set ships the assets, settings and the frontend config (data-nt-* on the <html> tag).

Only site-specific theming stays in the sitepackage: a native dark theme (brand colours), optional frontend tweaks and — if wanted — a "read aloud" button in the template (<f:render partial="ReadAloud"/> or [data-nt-tts]).