README

AmiPraha\AiTextTool is a Laravel package for OpenAI-powered text operations with multilingual language packs.

Features

Text summarization with requested output length.
Headline generation with requested max length.
Translation using the same output language resolution as all other operations.
Text repair (grammar, punctuation, readability improvements).
Native language packs for multiple languages to improve output quality with non-English source text.

Supported Languages

Languages are defined by the AmiPraha\AiTextTool\Language enum:

Language::English
Language::Czech
Language::Slovak
Language::German
Language::Spanish

Installation

composer require ami-praha/ai-text-tool

Publish package config:

php artisan vendor:publish --tag=ai-text-tool-config

Optional: publish language files so you can customize them:

php artisan vendor:publish --tag=ai-text-tool-languages

Configuration

File: config/ai-text-tool.php

default_language: default language used by package (must match a Language enum value).
custom_language_path: optional directory with language files that override package language files.
openai_api_key: OpenAI API key used for chat completion requests.
openai_model: OpenAI model used by package operations.
openai_base_url: optional OpenAI-compatible base URL (useful for gateways/proxies).
timeout: HTTP timeout in seconds.

Example:

return [
    'default_language' => 'english',
    'custom_language_path' => resource_path('ai-text-tool/languages'),
    'openai_api_key' => env('OPENAI_API_KEY'),
    'openai_model' => 'gpt-4.1-mini',
    'openai_base_url' => 'https://api.openai.com/v1',
    'timeout' => 60,
];

Environment variables:

OPENAI_API_KEY=your-api-key
AI_TEXT_TOOL_LANGUAGE=english
AI_TEXT_TOOL_LANGUAGE_PATH=/full/path/to/language/files
AI_TEXT_TOOL_OPENAI_MODEL=gpt-4.1-mini
AI_TEXT_TOOL_OPENAI_BASE_URL=https://api.openai.com/v1
AI_TEXT_TOOL_TIMEOUT=60

Usage

use AmiPraha\AiTextTool\Facades\AiTextTool;
use AmiPraha\AiTextTool\Language;

$summary = AiTextTool::summarize($sourceText, 450);
$headline = AiTextTool::headline($sourceText, 50);
$translation = AiTextTool::translate($sourceText);
$repaired = AiTextTool::repair($sourceText);

Fluent per-call output language override

All operations use the configured default_language for output. Use usingLanguage() to override the output language per call:

$summary = AiTextTool::usingLanguage(Language::Czech)->summarize($sourceText, 450);
$headline = AiTextTool::usingLanguage(Language::German)->headline($sourceText, 50);
$translation = AiTextTool::usingLanguage(Language::Slovak)->translate($sourceText);

The override is immutable and per-call, so it does not change global config defaults.

Optional source language hint

Use fromLanguage() to tell the LLM what language the source text is written in. This is optional -- when not provided, the model detects the source language automatically.

$translation = AiTextTool::usingLanguage(Language::German)->fromLanguage(Language::Czech)->translate($sourceText);
$summary = AiTextTool::fromLanguage(Language::Czech)->summarize($sourceText, 300);

Both usingLanguage() and fromLanguage() are immutable and can be chained in any order.

Requirements

PHP 8.2+
Laravel 12+
OpenAI API key.

ami-praha / ai-text-tool

Maintainers

Details