Installation

Purpose

Install EXT:ns_t3af on a Composer-based TYPO3 site. After install, run Quick Setup or add your first provider in AI Providers.

Premium license

To activate your T3Planet license and install this premium product, follow:

https://docs.t3planet.de/en/latest/License/Index.html

Step 1 — Composer

composer require nitsan/ns-t3af

Step 2 — Activate

vendor/bin/typo3 extension:setup -e ns_t3af
vendor/bin/typo3 cache:flush

Or: Admin Tools → Extensions → activate ns_t3af

Step 3 — Verify

After activation, confirm:

  • Extension is active in Extension Manager

  • AI Foundation appears in the backend sidebar

  • Database tables exist (for example tx_nst3af_provider, tx_nst3af_request_log)

  • Scheduler tasks for AI Foundation are listed

Step 4 — First configuration

  1. Open AI Foundation → Quick Setup (Quick Setup)

  2. Or go to AI Providers → add your first provider

  3. Run Test connection → mark one provider as Default

Upgrade from v1 (legacy API keys)

If you upgrade from an older version that stored API keys in Extension Configuration:

vendor/bin/typo3 upgrade:run ns_t3afMigrateExtConfProviders
vendor/bin/typo3 cache:flush

This moves old Extension Configuration keys into the AI Providers table.

Non-Composer install

  1. Copy ns_t3af to typo3conf/ext/

  2. Activate in Extension Manager

  3. Ensure scheduler and workspaces are active

  4. Run extension setup via Install Tool

Composer is recommended for updates. See Update Version.

Troubleshooting

Module not visible — Flush cache. Check the extension is active.

Tables missing — Re-run vendor/bin/typo3 extension:setup -e ns_t3af

Composer conflict — Remove other MCP server packages. See Known Problems.

Test connection fails after install — Check AI Providers and outbound HTTPS.