README

Ani-Nya i18n is a native Flarum 2.0 extension that provides AI-powered multilingual discussion translation.

It automatically detects when a discussion or post language differs from the user's preferred forum locale, generates a translated version, and displays it together with the original content.

Unlike browser-based translation solutions, Ani-Nya i18n integrates with Flarum's API and Mithril rendering system, using database-backed translation caching to reduce API usage.

Features

Auto-translate posts — posts are translated
mutiple translation engines — choose the one that fits your needs, Google, yandex, Baidu, Deepl, LLM (Openai form) is okay.
Multi-language support — auto-detects target language from user's forum locale
Homepage title translation — discussion list titles are translated
Shoutbox translation — third-party shoutbox widget messages are translated
User profile page — posts on user profiles are translated
Original text preserved — translated content shown with original text below

Supported Engines

Engine	API Key Required	Free Tier	Notes
OpenAI / DeepSeek	Yes	No	Best quality, supports custom prompts and base URL
DeepL	Yes	Yes (Free API)	High quality, auto-detects Free vs Pro from key suffix
Google Cloud Translate	Yes	Yes (500K chars/mo)	V2 API, reliable
Free Google Translate	No	Yes	No key needed, rate limited (~100 req/min)
Yandex Translate	Yes	Yes (1M chars/mo)	Cloud API
Baidu Translate	Yes	Yes (50K chars/mo)	Requires AppID + Secret
LibreTranslate	Optional	Yes (self-hosted)	Open source, supports custom instances

I tested OAI Deepl Google Free-Google Yandex and Baidu Libre is not tested due to is costs expensive.

Requirements

PHP 8.3+
Flarum 2.0.0-beta+

Installation

composer require u0-ani-nya/ani-nya_i18n

Then enable the extension in the Flarum admin dashboard.

Configuration

Go to Admin → Extensions → Auto Translate
Enable auto-translation
Select your preferred translation engine
Fill in the API key / credentials for the selected engine
Save settings

Target language is auto-detected from each user's language preference (forum language dropdown).

Engine Setup Guides

OpenAI / DeepSeek

API Key: Your OpenAI or compatible API key
Model: Default gpt-4o-mini, or use DeepSeek (deepseek-chat), etc.
Base URL: Default https://api.openai.com/v1. Change for compatible providers (e.g., https://api.deepseek.com for DeepSeek)
Prompt: Customize translation instructions

DeepL

API Key: Get from DeepL. Free API keys end with :fx
Free and Pro endpoints are auto-detected from the key

Google Cloud Translate

API Key: Create at Google Cloud Console → APIs & Services → Credentials → Create API Key
Enable "Cloud Translation API" first
Free tier: 500,000 characters/month

Free Google Translate

No configuration needed
Uses Google Translate internal API (free, no key required)
Rate limited (~100 requests/min)
Best for low-traffic forums or testing

Yandex Translate

API Key: Get from Yandex Cloud Console → API Keys
Enable Yandex Translate service first
Free tier: 1,000,000 characters/month

Baidu Translate

App ID + Secret: Get from Baidu Fanyi API → Developer Console
Free tier: 50,000 characters/month (standard)
Note: Uses Baidu-specific language codes internally (e.g., jp for Japanese, kor for Korean)

LibreTranslate

URL: Default https://libretranslate.com (public instance)
Change URL for self-hosted instances
API Key: Optional for public instance, may be required for self-hosted

How It Works

Translation is triggered when:
- A new discussion is created (auto-translate)
- A user views a discussion page
- A user views a profile page with posts
- Homepage is loaded (title translation)
Translations are cached in the i18n_translations database table
- Repeated views don't consume API quota
- Post edits trigger re-translation automatically
Frontend rendering:
- Discussion pages: VDOM injection (Mithril native)
- Homepage titles: DOM injection
- User profiles: VDOM injection
- Shoutbox: DOM injection with periodic polling

CLI Commands

# Translate a specific discussion
php flarum i18n:translate {discussion_id} --lang={lang_code}

# Translate all recent discussions (last 100)
php flarum i18n:translate --lang={lang_code}

License

This project uses a dual license:

Non-commercial use: AGPL-3.0 — Free for personal projects, education, and open source. Modifications must be open-sourced.
Commercial use: Requires a paid license. Contact mark#mail.ani-nya.com (replace # for @ ) for details.

See LICENSE for full terms.

Donate

If you find this extension useful, consider supporting its development:

BNB Chain: 0xEef952A66bd9116236E9C23Ca6f12272FA53c7Ce
爱发电
looking for my forum f.ani-nya.com（ACGN related）
or donate to charity organizations

u0-ani-nya / ani-nya_i18n

Maintainers

Package info

Statistics

Security