Translate huge mods in minutes, not days.
Stop wasting time on manual translation. Harness the power of GPT-5, Claude, and Llama 4 to localize your mod with context awareness.
⬇️ Download for Windows • 🐧 Download for Linux (Ubuntu) • 💬 Report Bug
Modding is fun. Translating thousands of lines of code is not. Existing tools are either too simple (Google Translate breaks code) or too expensive.
TranslatorHoi4 solves this:
- Context Aware: It knows it's translating a HOI4 mod. It tries to preserve variables, color codes (
§Y), and formatting. - Wallet Friendly: Use Free providers (G4F), Cheap (Groq/Fireworks), or Premium (OpenAI/Anthropic).
- Modern UI: No more command line. A beautiful Windows 11-style interface.
| Game | Status | Notes |
|---|---|---|
| Hearts of Iron IV | ✅ | Fully optimized prompts |
| Crusader Kings III | Works, prompts behave generically | |
| Europa Universalis IV | Works, prompts behave generically | |
| Stellaris | Works, prompts behave generically |
- Cloud Power: Support for OpenAI (GPT-5), Anthropic (Claude 4.5 Sonnet), Google Gemini, DeepL.
- Speed & Economy: Blazing fast translations with Groq and Fireworks.ai (Llama 4, DeepSeek).
- Free & Privacy: Use Ollama to run models locally on your GPU, or G4F for free web access.
- Smart Batching: Handles huge localization files by splitting them into safe chunks.
- Glossary System: Force specific terms (e.g., Manpower -> Lidská síла) to ensure consistency.
- Code Safety: Regex filters prevent the AI from translating code keys and variables.
- Resume Capability: Stopped halfway? The tool skips already translated lines next time.
- Go to the Releases Page.
- Download the
TranslatorHoi4_Windows.zipfile. - Extract it and run
TranslatorHoi4.exe.Note: If your antivirus flags the file, it is a false positive caused by PyInstaller. The code is 100% open source.
- Go to the Releases Page.
- Download the
TranslatorHoi4-ubuntu-latest.tar.gzfile. - Extract it and run the executable inside.
For other distributions or if you prefer to build from source:
# Clone the repo
git clone https://github.com/Locon213/TranslatorHoi4.git
cd TranslatorHoi4
# Setup environment
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
# Run
python -m translatorhoi4Not sure which provider to choose?
| Provider | Best For... | Cost | Speed |
|---|---|---|---|
| Groq | The Best Value. Extremely fast, very cheap, good quality (Llama 4). | $ | ⚡⚡⚡⚡⚡ |
| OpenAI | Top Quality. Best for complex lore and flavor text. | $$$ | ⚡⚡ |
| Claude | Natural Writing. Great for events and descriptions. | $$$ | ⚡⚡ |
| G4F | Zero Budget. Free, but unstable. Good for testing. | Free | ⚡ |
| Ollama | Privacy. Runs on your own PC. No data leaves your room. | Free | ⚡ (Depends on GPU) |
We welcome pull requests! If you want to add a new AI provider or fix a bug:
- Fork the repository.
- Create your feature branch (
git checkout -b feature/AmazingFeature). - Commit your changes.
- Open a Pull Request.
Distributed under the MIT License. See LICENSE for more information.
Don't forget to star the repo if this tool saved your time! ⭐