pagemachine / ai-tools
A TYPO3 extension that leverages artificial intelligence to enhance content and accessibility
Maintainers
Package info
github.com/pagemachine/ai-tools
Type:typo3-cms-extension
pkg:composer/pagemachine/ai-tools
Requires
- php: ^8.2
- typo3/cms-backend: ^12.4 || ^13.4 || ^14.0
- typo3/cms-core: ^12.4 || ^13.4 || ^14.0
- typo3/cms-fluid: ^12.4 || ^13.4 || ^14.0
- typo3/cms-frontend: ^12.4 || ^13.4 || ^14.0
Requires (Dev)
- ergebnis/composer-normalize: ^2.43
- jangregor/phpstan-prophecy: ^1.0 || ^2.0
- php-parallel-lint/php-console-highlighter: ^1.0
- php-parallel-lint/php-parallel-lint: ^1.4
- phpstan/extension-installer: ^1.4
- phpstan/phpstan: ^1.11 || ^2.0
- rector/rector: ^1.1 || ^2.0
- saschaegerer/phpstan-typo3: ^1.10 || ^3.0
- sclable/xml-lint: ^0.9.0
- slevomat/coding-standard: ^8.15
- squizlabs/php_codesniffer: ^4.0
- ssch/typo3-rector: ^2.6 || ^3.0
This package is auto-updated.
Last update: 2026-08-05 14:44:15 UTC
README
TYPO3 extension that uses AI to generate and translate image alt text automatically.
Requires: TYPO3 12.4–14.4 · PHP 8.2+
Installation
composer require pagemachine/ai-tools
Also available from the TYPO3 Extension Repository and GitHub releases.
Documentation
Full documentation at pagemachine.github.io/ai-tools.
Features
Alt text generation
Right-click any image in the File List and choose Generate A.I. Metadata to open the generation modal. The extension sends the image to the configured AI server and writes the result back to the file's metadata.
- Generate alt text in any site language
- Auto-translate to all other site languages in one step
- Customize the prompt used for generation (AI Tools > Prompts)
- Use Generate All on a folder to process multiple images at once
Prompt management
Go to AI Tools > Prompts to manage the prompts used for image description. Set one as the default; it will be pre-selected in the generation modal.
Server configuration
Go to AI Tools > Settings (admin only) to configure AI servers:
- API key (get a free key at aigude.io)
- Multiple servers supported; one set as default
Supported languages
AiGude generates descriptions natively in these languages:
English, German, Spanish, French, Italian, Portuguese, Dutch, Japanese, Korean, Arabic, Chinese, Russian, Hindi, Turkish, Hebrew
The description is generated in the language your prompt is written in, and translated to the target language only if the prompt language and the target language are different:
- Prompt in the target language — generated natively, no translation step. Example: prompt written in German, target German → German description directly.
- Prompt in a different language — generated, then translated. Example: prompt written in English, target German → generated in English, then translated to German.
For a site language that is not natively supported, write the prompt in any of the supported languages; the result is translated to the target.
Translation
DeepL and Google Translate are supported. The active provider is configurable per language under AI Tools > Settings.
RAG (context enrichment)
Optional, off by default. When enabled under AI Tools > Settings, alt-text generation is enriched with context from the page the image is actually placed on, resolved via sys_file_reference and read directly from the database. Descriptions can then name the actual people, events and organizations shown instead of guessing from pixels alone. Images that are not placed anywhere are described from the image alone. No external search service or indexing step is required.
Storage-scoped configuration
Useful for multi-site setups where each site has its own storage and API budget. Each file storage can be configured independently under System > File Storages > AI Tools tab:
- Enable/disable AI Tools for that storage
- Override AI server: route API calls for that storage to a specific server instead of the default
Testing
docker compose run --rm app composer build