Installation

Use this guide to install or reinstall T3AI Premium (EXT:ns_t3ai) with the required AI Foundation setup. T3AI depends on AI Foundation (EXT:ns_t3af) for AI providers, models, prompts, shared services, and request handling.

Important

If you are upgrading from an older T3AI installation, remove the existing extension first and complete the license activation flow again. This helps TYPO3 load the latest package and required dependencies correctly.

Step 1 — Remove the Existing Extension

If you are upgrading, uninstall EXT:ns_t3ai from your TYPO3 installation before installing the latest version.

This step is required because older extension files or cached registrations may conflict with the new AI Foundation-based setup.

Step 2 — Update the License Manager

Install the latest version of EXT:ns_license before continuing.

The License Manager controls access to T3Planet Premium packages. Older versions may not download the latest extension package or dependency information correctly.

Step 3 — Re-Activate the License

Non-Composer Installation

Use this workflow when your project installs T3Planet extensions from the TYPO3 backend:

Open Admin Tools → License Manager.
Remove the currently activated license key.
Save the changes.
Enter the license key again.
Activate the license.
Confirm that the latest T3AI package is downloaded.
Confirm that AI Foundation (EXT:ns_t3af) is installed automatically or available after activation.

Composer Installation

Use this workflow when your TYPO3 project is managed with Composer:

Remove the old T3AI package from the project if it is already installed.
Check the T3Planet Composer repository configuration.
Update the only parameter so the project can download T3AI and AI Foundation:
```
"only": [
  "nitsan/ns-t3ai",
  "nitsan/ns-t3af"
]
```
Install the latest T3AI package.
Run Composer update for the affected packages.
Verify that nitsan/ns-t3af is installed as a dependency.

Full license activation details: https://docs.t3planet.de/en/latest/License/LicenseActivation/Index.html

Step 4 — Install AI Foundation

AI Foundation (EXT:ns_t3af) is required before T3AI can be used. It provides the shared AI provider configuration, models, API access, logs, and service layer used by T3AI.

Composer installations should install AI Foundation automatically when the repository configuration is correct. Non-Composer users should verify that AI Foundation is installed after license activation.

Helpful AI Foundation references:

Step 5 — Run Database Analyzer

After installing or updating the extension, apply all pending database changes:

Open Admin Tools.
Go to Maintenance.
Open Analyze Database Structure.
Apply all pending database schema updates.

Run this before using T3AI modules in the TYPO3 backend.

Step 6 — Configure the AI Provider

After installation:

Open AI Foundation in the TYPO3 backend.
Configure your preferred AI provider.
Save the provider and model configuration.
Verify the AI connection with a test request.

T3AI will not function correctly until AI Foundation has a working AI provider configuration.

Step 7 — Verify the Installation

Before handing the system to editors, verify that:

EXT:ns_t3ai is installed and active.
EXT:ns_t3af is installed and active.
The T3AI license is active.
Database Analyzer changes are applied.
The AI provider is configured in AI Foundation.
TYPO3 caches are cleared.
T3AI backend modules load without errors.

For Free Version

To install the free version, open the TYPO3 Extension Manager and search for ns_t3ai.

Step 1: Open the Extension Manager module.

Step 2: Select Get the extension from the dropdown.

Step 3: Search for the extension key ns_t3ai.

Step 4: Click Retrieve/Update to import the extension from the repository.

Get the latest version from typo3.org: ns_t3ai

For Premium Version - License Activation

For license activation and premium installation details, see: https://docs.t3planet.de/en/latest/License/Index.html