Installation

Installation

Requirements

• Python 3.10 or newer
• Ollama (for local AI translation) or a Claude API key
• Linux, Windows, or macOS

Install dependencies

pip install -r requirements.txt

Core packages installed:

Package	Purpose
PySide6 >= 6.6	GUI framework
requests >= 2.31	HTTP calls to Ollama and APIs
cryptography >= 43.0	AES-256-GCM key storage
keyring >= 25.0	System keyring for Claude API key (optional)

Pull AI models (Ollama)

# Translation model (Gemma 3 27B fine-tune)
ollama pull 0xra/bethesda-translate

# Quality-check model (Gemma 4 E4B fine-tune)
ollama pull 0xra/bethesda-qc

Or create them from local GGUF files:

ollama create translategemma3-st -f Modelfile
ollama create qcgemma4-st -f Modelfile.qc

Run

python main.py

Logs are written to both stdout and translator.log in the project root.

Pre-built releases

Download the latest ZIP from the Releases page. Extract and run the bundled executable — no Python installation required.

See Release Verification to verify the download integrity before running.