# Supervertaler

[![PyPI version](https://badge.fury.io/py/supervertaler.svg)](https://pypi.org/project/Supervertaler/)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**Professional AI-enhanced translation workbench** with multi-LLM support (GPT-4, Claude, Gemini, Ollama), translation memory, glossary management, and seamless CAT tool integration (memoQ, Trados, CafeTran, Phrase, Déjà Vu).

---

## Installation

```bash
pip install supervertaler
supervertaler
```

Or run from source:

```bash
git clone https://github.com/michaelbeijer/Supervertaler.git
cd Supervertaler
pip install -r requirements.txt
python Supervertaler.py
```

---

## Key Features

- **Multi-LLM AI Translation** - OpenAI GPT-4/5, Anthropic Claude, Google Gemini, Local Ollama
- **Translation Memory** - Fuzzy matching TM with TMX import/export
- **Glossary System** - Priority-based term highlighting with forbidden term marking
- **Superlookup** - Unified concordance search across TM, glossaries, MT, and web resources
- **CAT Tool Integration** - memoQ XLIFF, Trados SDLPPX/SDLRPX, CafeTran, Phrase, Déjà Vu X3
- **Voice Commands** - Hands-free translation with OpenAI Whisper
- **Document Support** - DOCX, bilingual DOCX, PDF, Markdown, plain text

---

## Documentation

| Resource | Description |
|----------|-------------|
| [Online Manual](https://supervertaler.gitbook.io/superdocs/) | Quick start, guides, and troubleshooting |
| [Changelog](CHANGELOG.md) | Complete version history |
| [Keyboard Shortcuts](docs/guides/KEYBOARD_SHORTCUTS.md) | Shortcut reference |
| [FAQ](FAQ.md) | Common questions |
| [Website](https://supervertaler.com) | Project homepage |

---

## Requirements

- Python 3.10+
- PyQt6
- Windows, macOS, or Linux

---

## Contributing

- [Report bugs](https://github.com/michaelbeijer/Supervertaler/issues)
- [Request features](https://github.com/michaelbeijer/Supervertaler/discussions)
- [Contributing guide](CONTRIBUTING.md)
- [Stargazers](https://github.com/michaelbeijer/Supervertaler/stargazers) - See who's starred the project

---

## About

**Supervertaler** is maintained by [Michael Beijer](https://michaelbeijer.co.uk), a professional translator with 30 years of experience in technical and patent translation.

**License:** MIT - Free for personal and commercial use.

---

**Current Version:** See [CHANGELOG.md](CHANGELOG.md) for the latest release notes.
