Installation

Use this guide to install or reinstall T3AS Premium (EXT:ns_t3as) with the required AI Foundation setup. T3AS 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 T3AS 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_t3as 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:

1. Open Admin Tools → License Manager.

2. Remove the currently activated license key.

3. Save the changes.

4. Enter the license key again.

5. Activate the license.

6. Confirm that the latest T3AS package is downloaded.

7. 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:

1. Remove the old T3AS package from the project if it is already installed.

2. Check the T3Planet Composer repository configuration.

3. Update the only parameter so the project can download T3AS, T3CS, and AI Foundation:

   "only": [
     "nitsan/ns-t3as",
     "nitsan/ns-t3cs",
     "nitsan/ns-t3af"
   ]
   

4. Install the latest T3AS package.

5. Run Composer update for the affected packages.

6. 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 T3AS can be used. It provides the shared AI provider configuration, models, API access, logs, and service layer used by T3AS.

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.

Premium Version

For license activation and access to premium features, see: https://docs.t3planet.de/en/latest/License/Index.html

T3AS setup and AI Foundation

Before you use T3AS, install AI Foundation (EXT:ns_t3af). It is the parent extension and provides the shared AI models, provider configuration, authentication, and core AI services used by T3AS.

These extensions do not change how your website looks on the frontend. They work in the backend and support T3AS technically.

Please keep both extensions enabled.

T3AS

T3AS provides a central backend module where you can:

• Manage data sources such as sitemaps, PDFs, TYPO3 pages, web pages, Q&A pairs, and optional index sources such as Ke Search or Solr.

• Run a training pipeline that syncs content, creates embeddings, and keeps AI search up to date.

• Configure and monitor AI Search.

• View usage analytics for search activity.

AI Foundation (ns_t3af)

AI Foundation is the shared AI infrastructure for T3Planet AI Universe extensions. Complete the parent setup first, then return to T3AS installation.

Helpful AI Foundation references:

• AI Foundation Installation

• AI Foundation Configuration

• AI Providers

Step 5 — Run Database Analyzer

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

1. Open Admin Tools.

2. Go to Maintenance.

3. Open Analyze Database Structure.

4. Apply all pending database schema updates.

Run this before using T3AS modules in the TYPO3 backend.

Step 6 — Configure the AI Provider

After installation:

1. Open AI Foundation in the TYPO3 backend.

2. Configure your preferred AI provider.

3. Save the provider and model configuration.

4. Verify the AI connection with a test request.

T3AS 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_t3as is installed and active.

• EXT:ns_t3af is installed and active.

• The T3AS license is active.

• Database Analyzer changes are applied.

• The AI provider is configured in AI Foundation.

• TYPO3 caches are cleared.

• T3AS backend modules load without errors.