Supervertaler


NameSupervertaler JSON
Version 3.7.1 PyPI version JSON
download
home_pagehttps://github.com/michaelbeijer/Supervertaler
SummaryAI-powered context-aware translation tool for professional translators
upload_time2025-10-20 21:10:54
maintainerNone
docs_urlNone
authorMichael Beijer
requires_python>=3.12
licenseMIT
keywords translation cat ai llm gpt claude gemini translation-memory localization
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Supervertaler v3.7.1

🎯 **Context-aware, LLM-powered CAT editor for professional translators** — Revolutionary segment-based translation tool with AI-enhanced prompts, PDF Rescue OCR, and seamless CAT tool integration.

**Latest Version**: v3.7.1 (October 20, 2025)

---

## ✨ What is Supervertaler?

Supervertaler is a **professional Computer-Aided Translation (CAT) editor** designed by a 30-year veteran translator for translators. It combines:

- 🤖 **Multiple AI providers** - OpenAI GPT-4, Anthropic Claude, Google Gemini
- 🎯 **Context-aware translation** - Full document understanding, figure context, translation memory
- 📚 **Unified Prompt Library** - System Prompts (AI role) + Custom Instructions (user preferences)
- 🆘 **PDF Rescue** - AI-powered OCR for badly-formatted PDFs
- ✅ **Professional CAT features** - Segment editing, grid pagination, dual selection (memoQ-style)
- 🔗 **CAT tool integration** - memoQ, CafeTran, Trados Studio support
- 📊 **Smart auto-export** - Session reports, TMX, TSV, XLIFF, Excel
- 💾 **Translation Memory** - Fuzzy matching with segment context

---

## 🚀 Current Version: v3.7.1

**File**: `Supervertaler_v3.7.1.py`

### 📌 What's New in v3.7.1

🔒 **Security & Configuration Updates** (v3.7.1 - October 20, 2025):
- 🛡️ **Data Folder Security** - Reorganized user data handling to separate dev and user environments
- 🔐 **API Keys Protection** - Moved `api_keys.txt` to user data folder (never committed to git)
- 📁 **Configurable Data Folders** - Users can now choose where to store projects and resources on first launch
- ⚙️ **Settings Menu** - Added "Change Data Folder" option to Settings tab
- 🐛 **Bug Fixes** - Fixed Tkinter error in Prompt Library tab switching

### 📌 What's New in v3.7.0

✨ **Product Unification**:
- Unified product focus on v3.x CAT Edition
- Single clear product line for users and LSPs
- Simplified repository and documentation

📁 **Folder Structure Reorganization** (v3.6.9):
- `Prompt_Library/System_prompts/` - Domain-specific prompts (19 files)
- `Prompt_Library/Custom_instructions/` - User preferences (8 files)
- `Translation_Resources/Glossaries/` - Terminology databases
- `Translation_Resources/TMs/` - Translation Memory files
- `Translation_Resources/Non-translatables/` - Non-translatable lists
- `Translation_Resources/Segmentation_rules/` - Segmentation rules

📝 **Markdown Prompt Format** (v3.6.8):
- All prompts now in Markdown with YAML frontmatter
- Human-readable format (no escaped JSON)
- Beautiful Markdown tables for glossaries
- Mixed format support (loads both `.json` and `.md`)

### 🎯 Core Features

**Translation Engine**:
- ✅ Multiple AI providers with model selection
- ✅ Custom prompts with variable substitution (`{source_lang}`, `{target_lang}`, `{domain}`, etc.)
- ✅ Translation Memory with fuzzy matching
- ✅ Full document context for better accuracy
- ✅ Tracked changes learning (learns from your edits)

**Professional CAT Editor**:
- ✅ **Grid View** - 50 segments per page (10x faster loading!)
- ✅ **List View** - Simple inline editing
- ✅ **Document View** - Full document layout
- ✅ **Dual Selection** - memoQ-style multi-segment selection
- ✅ **Smart Pagination** - Instant navigation between pages
- ✅ **Figure Context** - Multimodal AI with image understanding

**Prompt Management**:
- 🎯 **System Prompts** - Define AI behavior (specialist roles)
- 📝 **Custom Instructions** - User preferences & guidelines
- 🤖 **Prompt Assistant** - AI-powered document analysis and prompt generation
- 🔍 **Prompt Library** - Browse, edit, create, filter prompts

**PDF Rescue - AI-Powered OCR** (v3.5+):
- 📄 One-click PDF import with automatic page extraction
- 🧠 GPT-4 Vision for badly-formatted PDFs
- 🎨 Optional formatting preservation (markdown-based)
- 🔍 Smart redaction/stamp handling with language-aware placeholders
- 📊 Professional session reports with branding

**CAT Tool Integration**:
- ☕ **CafeTran Bilingual DOCX** - AI-based pipe symbol preservation
- 📊 **memoQ Bilingual DOCX** - Programmatic formatting preservation
- 🏢 **Trados Studio** - XLIFF import/export with tag preservation
- 💾 **Export Formats** - DOCX, TSV, JSON, XLIFF, TMX, Excel, HTML, Markdown

**Data Management**:
- 💾 Project save/load with full context preservation
- 📁 Organized folder structure (Prompt_Library, Translation_Resources, Projects)
- 🔄 Automatic backup capability
- 👥 Dev mode with parallel folder structure (`user data/` vs `user data_private/`)

---

## 🔧 Getting Started

### Installation - Choose Your Method

Supervertaler v3.7.1 is available in **three ways**:

#### **1️⃣ Windows Executable (Easiest - Recommended for Most Users)**

No Python installation required!

1. **Download**: Get the latest release from [GitHub Releases](https://github.com/michaelbeijer/Supervertaler/releases)
2. **Extract**: Unzip `Supervertaler-v3.7.1.zip` to any folder
3. **Run**: Double-click `Supervertaler/Supervertaler.exe`
4. **Configure**: Add your API keys and start translating!

**Advantages**:
- ✅ No Python needed
- ✅ Works on any Windows system
- ✅ All documentation and templates included
- ✅ Portable - run from USB stick
- ✅ Fastest startup

#### **2️⃣ Python Package (pip - For Python Developers)**

For those with Python 3.12+ installed:

```bash
pip install supervertaler
```

Then run:
```bash
python -m Supervertaler_v3.7.1
```

> **Note**: v3.7.0 has been yanked from PyPI due to security updates. v3.7.1 includes critical data folder security improvements.

**Advantages**:
- ✅ Easy updates: `pip install --upgrade supervertaler`
- ✅ Integrates with Python projects
- ✅ Full source code visible
- ✅ Can customize and extend

#### **3️⃣ From Source (For Contributors and Developers)**

```bash
# Clone repository
git clone https://github.com/michaelbeijer/Supervertaler.git
cd Supervertaler

# Install dependencies
pip install -r requirements.txt

# Run application
python Supervertaler_v3.7.1.py
```

**Advantages**:
- ✅ Latest development version
- ✅ Full access to source code
- ✅ Can contribute improvements
- ✅ Perfect for customization

---

### Quick Comparison Table

| Method | Setup Time | Python Required | Updates | Best For |
|--------|-----------|-----------------|---------|----------|
| **Windows Exe** | 30 seconds | ❌ No | Manual | Most users |
| **pip** | 1 minute | ✅ Yes (3.12+) | `pip upgrade` | Developers |
| **From Source** | 2 minutes | ✅ Yes (3.12+) | `git pull` | Contributors |

---

### First Steps

1. **Configure API Keys**: Set up OpenAI, Claude, or Gemini credentials
2. **Explore System Prompts** (Ctrl+P) - Browse domain-specific specialist prompts
3. **Create Custom Instructions** - Define your translation preferences
4. **Open a Document** - Import DOCX, create segments
5. **Start Translating** - Use System Prompts or custom instructions
6. **Export Results** - Session reports, TMX, auto-export to CAT tools

---

## 📖 Documentation

- **User Guide**: [USER_GUIDE.md](USER_GUIDE.md)
- **CAT Tool Integration**:
  - [CafeTran Integration](.dev/docs/features/CAFETRAN_SUPPORT.md)
  - [memoQ Integration](.dev/docs/features/MEMOQ_SUPPORT.md)
- **Changelog**: [CHANGELOG.md](CHANGELOG.md)
- **Website**: [supervertaler.com](https://supervertaler.com)

---

## 🎯 Why Supervertaler?

### For Professional Translators
- ✅ Built by a professional translator (30 years experience)
- ✅ Designed for real translation workflows, not generic AI
- ✅ Integrates with your existing CAT tools
- ✅ Context-aware for better accuracy
- ✅ Fully open source - no vendor lock-in

### For Translation Agencies (LSPs)
- ✅ Improve translator productivity (20-40% gains documented)
- ✅ Consistent quality across your translator pool
- ✅ Works with your existing CAT tool infrastructure
- ✅ Open source means you own your workflow
- ✅ Custom training and consulting available

### Why Open Source?
- 🔓 **Full transparency** - See exactly what the AI is doing
- 🔓 **No vendor lock-in** - Own your translation workflow
- 🔓 **Community-driven** - Contribute features, report bugs
- 🔓 **Sustainable** - Supported through consulting and training

---

## 🚀 Features Overview

### AI Translation Engine
- **Multiple providers** - OpenAI, Anthropic, Google Gemini
- **Multimodal support** - GPT-4 Vision for figures and context
- **Batch processing** - Translate entire documents at once
- **Context preservation** - Full document analysis before translation

### Professional Prompts
- **19 System Prompts** - Domain specialists (Legal, Medical, Patent, Tech, etc.)
- **8 Custom Instructions** - User-defined preferences
- **Prompt Assistant** - Generate custom prompts from document analysis
- **Markdown format** - Human-readable, easy to edit

### Translation Memory
- **Fuzzy matching** - Find similar segments
- **Context display** - See source alongside match
- **Segment history** - Learn from previous translations
- **TMX export** - Industry-standard format

### Professional Export
- **Auto-reports** - Session reports in HTML and Markdown
- **CAT tool export** - Direct memoQ and CafeTran DOCX
- **Format preservation** - Bold, italic, formatting maintained
- **Tag safety** - XLIFF tags completely preserved

---

## 📊 Performance

- ⚡ **Grid pagination** - 10x faster loading (50 segments/page)
- ⚡ **Smart caching** - Reduce API calls with TM fuzzy matching
- ⚡ **Batch translation** - Process 100+ segments simultaneously
- ⚡ **Responsive UI** - Stays responsive during large operations

---

## 🤝 Community & Support

- **GitHub Issues**: [Report bugs or request features](https://github.com/michaelbeijer/Supervertaler/issues)
- **GitHub Discussions**: [Community chat and questions](https://github.com/michaelbeijer/Supervertaler/discussions)
- **Website**: [supervertaler.com](https://supervertaler.com)
- **Professional Website**: [michaelbeijer.co.uk](https://michaelbeijer.co.uk)

---

## 💡 Use Cases

### Individual Translators
- Enhance personal productivity with AI
- Maintain consistent terminology
- Work faster without sacrificing quality
- Leverage domain-specific prompts

### Translation Agencies
- Train all translators with same prompts
- Maintain company-wide consistency
- Increase productivity across the team
- Reduce review/QA time
- Custom LSP consulting available

### Translation Students
- Learn professional translation workflows
- Understand CAT tool integration
- Practice with real-world tools
- Open source to study and modify

---

## 🔐 Privacy & Security

- **No data collection** - Your translations stay on your computer
- **Local processing** - Translations processed locally by default
- **API keys encrypted** - Credentials stored securely
- **Open source** - Full audit trail, no hidden code
- **GDPR compliant** - User data never leaves your system

---

## 📄 License

**MIT License** - Fully open source and free

This software is provided as-is for both personal and commercial use.

---

## 👤 About

**Supervertaler** is maintained by Michael Beijer, a professional translator with 30 years of experience in technical and patent translation. The project represents a personal passion for building tools that make translators' lives easier.

- 🌐 **Website**: [michaelbeijer.co.uk](https://michaelbeijer.co.uk)
- 💼 **Professional**: [ProZ Profile](https://www.proz.com/profile/652138)
- 🔗 **LinkedIn**: [linkedin.com/in/michaelbeijer](https://www.linkedin.com/in/michaelbeijer/)

---

## 🎯 Roadmap

### Planned Features (v3.8+)
- Enhanced Prompt Assistant with auto-refinement
- Glossary management UI improvements
- Advanced TM features (penalty weights, leverage scoring)
- Integration marketplace (partner CAT tools)
- Professional cloud hosting option (optional)

### Community Contributions Welcome
We're looking for:
- 🐛 Bug reports and feature requests
- 💡 Prompt contributions (System Prompts, Custom Instructions)
- 📖 Documentation improvements
- 🌍 Translations and localization
- 🤝 Code contributions

---

## 📞 Questions?

Check out:
1. **README.md** (this file) - Overview
2. **[CHANGELOG.md](CHANGELOG.md)** - What's new
3. **[USER_GUIDE.md](USER_GUIDE.md)** - Detailed usage instructions
4. **GitHub Issues** - Common questions
5. **Website Documentation** - tutorials and guides

---

**Last Updated**: October 20, 2025  
**Version**: v3.7.1  
**Status**: Active Development  
**License**: MIT (Open Source)  
**Security Status**: Current - Security patches applied in v3.7.1

---

> 🎯 **Supervertaler**: Empowering professional translators with intelligent, context-aware AI tools. Built by translators, for translators.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/michaelbeijer/Supervertaler",
    "name": "Supervertaler",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.12",
    "maintainer_email": "Michael Beijer <info@michaelbeijer.co.uk>",
    "keywords": "translation, CAT, AI, LLM, GPT, Claude, Gemini, translation-memory, localization",
    "author": "Michael Beijer",
    "author_email": "Michael Beijer <info@michaelbeijer.co.uk>",
    "download_url": "https://files.pythonhosted.org/packages/1d/d8/30b04b21e52b0551855febc53083e73f113e9035441e8147dd5d363bd81a/supervertaler-3.7.1.tar.gz",
    "platform": null,
    "description": "# Supervertaler v3.7.1\r\n\r\n\ud83c\udfaf **Context-aware, LLM-powered CAT editor for professional translators** \u2014 Revolutionary segment-based translation tool with AI-enhanced prompts, PDF Rescue OCR, and seamless CAT tool integration.\r\n\r\n**Latest Version**: v3.7.1 (October 20, 2025)\r\n\r\n---\r\n\r\n## \u2728 What is Supervertaler?\r\n\r\nSupervertaler is a **professional Computer-Aided Translation (CAT) editor** designed by a 30-year veteran translator for translators. It combines:\r\n\r\n- \ud83e\udd16 **Multiple AI providers** - OpenAI GPT-4, Anthropic Claude, Google Gemini\r\n- \ud83c\udfaf **Context-aware translation** - Full document understanding, figure context, translation memory\r\n- \ud83d\udcda **Unified Prompt Library** - System Prompts (AI role) + Custom Instructions (user preferences)\r\n- \ud83c\udd98 **PDF Rescue** - AI-powered OCR for badly-formatted PDFs\r\n- \u2705 **Professional CAT features** - Segment editing, grid pagination, dual selection (memoQ-style)\r\n- \ud83d\udd17 **CAT tool integration** - memoQ, CafeTran, Trados Studio support\r\n- \ud83d\udcca **Smart auto-export** - Session reports, TMX, TSV, XLIFF, Excel\r\n- \ud83d\udcbe **Translation Memory** - Fuzzy matching with segment context\r\n\r\n---\r\n\r\n## \ud83d\ude80 Current Version: v3.7.1\r\n\r\n**File**: `Supervertaler_v3.7.1.py`\r\n\r\n### \ud83d\udccc What's New in v3.7.1\r\n\r\n\ud83d\udd12 **Security & Configuration Updates** (v3.7.1 - October 20, 2025):\r\n- \ud83d\udee1\ufe0f **Data Folder Security** - Reorganized user data handling to separate dev and user environments\r\n- \ud83d\udd10 **API Keys Protection** - Moved `api_keys.txt` to user data folder (never committed to git)\r\n- \ud83d\udcc1 **Configurable Data Folders** - Users can now choose where to store projects and resources on first launch\r\n- \u2699\ufe0f **Settings Menu** - Added \"Change Data Folder\" option to Settings tab\r\n- \ud83d\udc1b **Bug Fixes** - Fixed Tkinter error in Prompt Library tab switching\r\n\r\n### \ud83d\udccc What's New in v3.7.0\r\n\r\n\u2728 **Product Unification**:\r\n- Unified product focus on v3.x CAT Edition\r\n- Single clear product line for users and LSPs\r\n- Simplified repository and documentation\r\n\r\n\ud83d\udcc1 **Folder Structure Reorganization** (v3.6.9):\r\n- `Prompt_Library/System_prompts/` - Domain-specific prompts (19 files)\r\n- `Prompt_Library/Custom_instructions/` - User preferences (8 files)\r\n- `Translation_Resources/Glossaries/` - Terminology databases\r\n- `Translation_Resources/TMs/` - Translation Memory files\r\n- `Translation_Resources/Non-translatables/` - Non-translatable lists\r\n- `Translation_Resources/Segmentation_rules/` - Segmentation rules\r\n\r\n\ud83d\udcdd **Markdown Prompt Format** (v3.6.8):\r\n- All prompts now in Markdown with YAML frontmatter\r\n- Human-readable format (no escaped JSON)\r\n- Beautiful Markdown tables for glossaries\r\n- Mixed format support (loads both `.json` and `.md`)\r\n\r\n### \ud83c\udfaf Core Features\r\n\r\n**Translation Engine**:\r\n- \u2705 Multiple AI providers with model selection\r\n- \u2705 Custom prompts with variable substitution (`{source_lang}`, `{target_lang}`, `{domain}`, etc.)\r\n- \u2705 Translation Memory with fuzzy matching\r\n- \u2705 Full document context for better accuracy\r\n- \u2705 Tracked changes learning (learns from your edits)\r\n\r\n**Professional CAT Editor**:\r\n- \u2705 **Grid View** - 50 segments per page (10x faster loading!)\r\n- \u2705 **List View** - Simple inline editing\r\n- \u2705 **Document View** - Full document layout\r\n- \u2705 **Dual Selection** - memoQ-style multi-segment selection\r\n- \u2705 **Smart Pagination** - Instant navigation between pages\r\n- \u2705 **Figure Context** - Multimodal AI with image understanding\r\n\r\n**Prompt Management**:\r\n- \ud83c\udfaf **System Prompts** - Define AI behavior (specialist roles)\r\n- \ud83d\udcdd **Custom Instructions** - User preferences & guidelines\r\n- \ud83e\udd16 **Prompt Assistant** - AI-powered document analysis and prompt generation\r\n- \ud83d\udd0d **Prompt Library** - Browse, edit, create, filter prompts\r\n\r\n**PDF Rescue - AI-Powered OCR** (v3.5+):\r\n- \ud83d\udcc4 One-click PDF import with automatic page extraction\r\n- \ud83e\udde0 GPT-4 Vision for badly-formatted PDFs\r\n- \ud83c\udfa8 Optional formatting preservation (markdown-based)\r\n- \ud83d\udd0d Smart redaction/stamp handling with language-aware placeholders\r\n- \ud83d\udcca Professional session reports with branding\r\n\r\n**CAT Tool Integration**:\r\n- \u2615 **CafeTran Bilingual DOCX** - AI-based pipe symbol preservation\r\n- \ud83d\udcca **memoQ Bilingual DOCX** - Programmatic formatting preservation\r\n- \ud83c\udfe2 **Trados Studio** - XLIFF import/export with tag preservation\r\n- \ud83d\udcbe **Export Formats** - DOCX, TSV, JSON, XLIFF, TMX, Excel, HTML, Markdown\r\n\r\n**Data Management**:\r\n- \ud83d\udcbe Project save/load with full context preservation\r\n- \ud83d\udcc1 Organized folder structure (Prompt_Library, Translation_Resources, Projects)\r\n- \ud83d\udd04 Automatic backup capability\r\n- \ud83d\udc65 Dev mode with parallel folder structure (`user data/` vs `user data_private/`)\r\n\r\n---\r\n\r\n## \ud83d\udd27 Getting Started\r\n\r\n### Installation - Choose Your Method\r\n\r\nSupervertaler v3.7.1 is available in **three ways**:\r\n\r\n#### **1\ufe0f\u20e3 Windows Executable (Easiest - Recommended for Most Users)**\r\n\r\nNo Python installation required!\r\n\r\n1. **Download**: Get the latest release from [GitHub Releases](https://github.com/michaelbeijer/Supervertaler/releases)\r\n2. **Extract**: Unzip `Supervertaler-v3.7.1.zip` to any folder\r\n3. **Run**: Double-click `Supervertaler/Supervertaler.exe`\r\n4. **Configure**: Add your API keys and start translating!\r\n\r\n**Advantages**:\r\n- \u2705 No Python needed\r\n- \u2705 Works on any Windows system\r\n- \u2705 All documentation and templates included\r\n- \u2705 Portable - run from USB stick\r\n- \u2705 Fastest startup\r\n\r\n#### **2\ufe0f\u20e3 Python Package (pip - For Python Developers)**\r\n\r\nFor those with Python 3.12+ installed:\r\n\r\n```bash\r\npip install supervertaler\r\n```\r\n\r\nThen run:\r\n```bash\r\npython -m Supervertaler_v3.7.1\r\n```\r\n\r\n> **Note**: v3.7.0 has been yanked from PyPI due to security updates. v3.7.1 includes critical data folder security improvements.\r\n\r\n**Advantages**:\r\n- \u2705 Easy updates: `pip install --upgrade supervertaler`\r\n- \u2705 Integrates with Python projects\r\n- \u2705 Full source code visible\r\n- \u2705 Can customize and extend\r\n\r\n#### **3\ufe0f\u20e3 From Source (For Contributors and Developers)**\r\n\r\n```bash\r\n# Clone repository\r\ngit clone https://github.com/michaelbeijer/Supervertaler.git\r\ncd Supervertaler\r\n\r\n# Install dependencies\r\npip install -r requirements.txt\r\n\r\n# Run application\r\npython Supervertaler_v3.7.1.py\r\n```\r\n\r\n**Advantages**:\r\n- \u2705 Latest development version\r\n- \u2705 Full access to source code\r\n- \u2705 Can contribute improvements\r\n- \u2705 Perfect for customization\r\n\r\n---\r\n\r\n### Quick Comparison Table\r\n\r\n| Method | Setup Time | Python Required | Updates | Best For |\r\n|--------|-----------|-----------------|---------|----------|\r\n| **Windows Exe** | 30 seconds | \u274c No | Manual | Most users |\r\n| **pip** | 1 minute | \u2705 Yes (3.12+) | `pip upgrade` | Developers |\r\n| **From Source** | 2 minutes | \u2705 Yes (3.12+) | `git pull` | Contributors |\r\n\r\n---\r\n\r\n### First Steps\r\n\r\n1. **Configure API Keys**: Set up OpenAI, Claude, or Gemini credentials\r\n2. **Explore System Prompts** (Ctrl+P) - Browse domain-specific specialist prompts\r\n3. **Create Custom Instructions** - Define your translation preferences\r\n4. **Open a Document** - Import DOCX, create segments\r\n5. **Start Translating** - Use System Prompts or custom instructions\r\n6. **Export Results** - Session reports, TMX, auto-export to CAT tools\r\n\r\n---\r\n\r\n## \ud83d\udcd6 Documentation\r\n\r\n- **User Guide**: [USER_GUIDE.md](USER_GUIDE.md)\r\n- **CAT Tool Integration**:\r\n  - [CafeTran Integration](.dev/docs/features/CAFETRAN_SUPPORT.md)\r\n  - [memoQ Integration](.dev/docs/features/MEMOQ_SUPPORT.md)\r\n- **Changelog**: [CHANGELOG.md](CHANGELOG.md)\r\n- **Website**: [supervertaler.com](https://supervertaler.com)\r\n\r\n---\r\n\r\n## \ud83c\udfaf Why Supervertaler?\r\n\r\n### For Professional Translators\r\n- \u2705 Built by a professional translator (30 years experience)\r\n- \u2705 Designed for real translation workflows, not generic AI\r\n- \u2705 Integrates with your existing CAT tools\r\n- \u2705 Context-aware for better accuracy\r\n- \u2705 Fully open source - no vendor lock-in\r\n\r\n### For Translation Agencies (LSPs)\r\n- \u2705 Improve translator productivity (20-40% gains documented)\r\n- \u2705 Consistent quality across your translator pool\r\n- \u2705 Works with your existing CAT tool infrastructure\r\n- \u2705 Open source means you own your workflow\r\n- \u2705 Custom training and consulting available\r\n\r\n### Why Open Source?\r\n- \ud83d\udd13 **Full transparency** - See exactly what the AI is doing\r\n- \ud83d\udd13 **No vendor lock-in** - Own your translation workflow\r\n- \ud83d\udd13 **Community-driven** - Contribute features, report bugs\r\n- \ud83d\udd13 **Sustainable** - Supported through consulting and training\r\n\r\n---\r\n\r\n## \ud83d\ude80 Features Overview\r\n\r\n### AI Translation Engine\r\n- **Multiple providers** - OpenAI, Anthropic, Google Gemini\r\n- **Multimodal support** - GPT-4 Vision for figures and context\r\n- **Batch processing** - Translate entire documents at once\r\n- **Context preservation** - Full document analysis before translation\r\n\r\n### Professional Prompts\r\n- **19 System Prompts** - Domain specialists (Legal, Medical, Patent, Tech, etc.)\r\n- **8 Custom Instructions** - User-defined preferences\r\n- **Prompt Assistant** - Generate custom prompts from document analysis\r\n- **Markdown format** - Human-readable, easy to edit\r\n\r\n### Translation Memory\r\n- **Fuzzy matching** - Find similar segments\r\n- **Context display** - See source alongside match\r\n- **Segment history** - Learn from previous translations\r\n- **TMX export** - Industry-standard format\r\n\r\n### Professional Export\r\n- **Auto-reports** - Session reports in HTML and Markdown\r\n- **CAT tool export** - Direct memoQ and CafeTran DOCX\r\n- **Format preservation** - Bold, italic, formatting maintained\r\n- **Tag safety** - XLIFF tags completely preserved\r\n\r\n---\r\n\r\n## \ud83d\udcca Performance\r\n\r\n- \u26a1 **Grid pagination** - 10x faster loading (50 segments/page)\r\n- \u26a1 **Smart caching** - Reduce API calls with TM fuzzy matching\r\n- \u26a1 **Batch translation** - Process 100+ segments simultaneously\r\n- \u26a1 **Responsive UI** - Stays responsive during large operations\r\n\r\n---\r\n\r\n## \ud83e\udd1d Community & Support\r\n\r\n- **GitHub Issues**: [Report bugs or request features](https://github.com/michaelbeijer/Supervertaler/issues)\r\n- **GitHub Discussions**: [Community chat and questions](https://github.com/michaelbeijer/Supervertaler/discussions)\r\n- **Website**: [supervertaler.com](https://supervertaler.com)\r\n- **Professional Website**: [michaelbeijer.co.uk](https://michaelbeijer.co.uk)\r\n\r\n---\r\n\r\n## \ud83d\udca1 Use Cases\r\n\r\n### Individual Translators\r\n- Enhance personal productivity with AI\r\n- Maintain consistent terminology\r\n- Work faster without sacrificing quality\r\n- Leverage domain-specific prompts\r\n\r\n### Translation Agencies\r\n- Train all translators with same prompts\r\n- Maintain company-wide consistency\r\n- Increase productivity across the team\r\n- Reduce review/QA time\r\n- Custom LSP consulting available\r\n\r\n### Translation Students\r\n- Learn professional translation workflows\r\n- Understand CAT tool integration\r\n- Practice with real-world tools\r\n- Open source to study and modify\r\n\r\n---\r\n\r\n## \ud83d\udd10 Privacy & Security\r\n\r\n- **No data collection** - Your translations stay on your computer\r\n- **Local processing** - Translations processed locally by default\r\n- **API keys encrypted** - Credentials stored securely\r\n- **Open source** - Full audit trail, no hidden code\r\n- **GDPR compliant** - User data never leaves your system\r\n\r\n---\r\n\r\n## \ud83d\udcc4 License\r\n\r\n**MIT License** - Fully open source and free\r\n\r\nThis software is provided as-is for both personal and commercial use.\r\n\r\n---\r\n\r\n## \ud83d\udc64 About\r\n\r\n**Supervertaler** is maintained by Michael Beijer, a professional translator with 30 years of experience in technical and patent translation. The project represents a personal passion for building tools that make translators' lives easier.\r\n\r\n- \ud83c\udf10 **Website**: [michaelbeijer.co.uk](https://michaelbeijer.co.uk)\r\n- \ud83d\udcbc **Professional**: [ProZ Profile](https://www.proz.com/profile/652138)\r\n- \ud83d\udd17 **LinkedIn**: [linkedin.com/in/michaelbeijer](https://www.linkedin.com/in/michaelbeijer/)\r\n\r\n---\r\n\r\n## \ud83c\udfaf Roadmap\r\n\r\n### Planned Features (v3.8+)\r\n- Enhanced Prompt Assistant with auto-refinement\r\n- Glossary management UI improvements\r\n- Advanced TM features (penalty weights, leverage scoring)\r\n- Integration marketplace (partner CAT tools)\r\n- Professional cloud hosting option (optional)\r\n\r\n### Community Contributions Welcome\r\nWe're looking for:\r\n- \ud83d\udc1b Bug reports and feature requests\r\n- \ud83d\udca1 Prompt contributions (System Prompts, Custom Instructions)\r\n- \ud83d\udcd6 Documentation improvements\r\n- \ud83c\udf0d Translations and localization\r\n- \ud83e\udd1d Code contributions\r\n\r\n---\r\n\r\n## \ud83d\udcde Questions?\r\n\r\nCheck out:\r\n1. **README.md** (this file) - Overview\r\n2. **[CHANGELOG.md](CHANGELOG.md)** - What's new\r\n3. **[USER_GUIDE.md](USER_GUIDE.md)** - Detailed usage instructions\r\n4. **GitHub Issues** - Common questions\r\n5. **Website Documentation** - tutorials and guides\r\n\r\n---\r\n\r\n**Last Updated**: October 20, 2025  \r\n**Version**: v3.7.1  \r\n**Status**: Active Development  \r\n**License**: MIT (Open Source)  \r\n**Security Status**: Current - Security patches applied in v3.7.1\r\n\r\n---\r\n\r\n> \ud83c\udfaf **Supervertaler**: Empowering professional translators with intelligent, context-aware AI tools. Built by translators, for translators.\r\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "AI-powered context-aware translation tool for professional translators",
    "version": "3.7.1",
    "project_urls": {
        "Author Website": "https://michaelbeijer.co.uk",
        "Bug Tracker": "https://github.com/michaelbeijer/Supervertaler/issues",
        "Documentation": "https://michaelbeijer.co.uk",
        "Homepage": "https://github.com/michaelbeijer/Supervertaler",
        "Repository": "https://github.com/michaelbeijer/Supervertaler.git"
    },
    "split_keywords": [
        "translation",
        " cat",
        " ai",
        " llm",
        " gpt",
        " claude",
        " gemini",
        " translation-memory",
        " localization"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "9077f137234b12263bf061ea4762e95ab40f6492c0c2968345bf528d15570667",
                "md5": "1ef2fde2214da87ae1df4a13e1fb655d",
                "sha256": "b6b3e3135c896f027ee1fdf7ee5344ec32c2a9a5637d96a8a5bc0c222e2f0fad"
            },
            "downloads": -1,
            "filename": "supervertaler-3.7.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "1ef2fde2214da87ae1df4a13e1fb655d",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.12",
            "size": 77765,
            "upload_time": "2025-10-20T21:10:52",
            "upload_time_iso_8601": "2025-10-20T21:10:52.257160Z",
            "url": "https://files.pythonhosted.org/packages/90/77/f137234b12263bf061ea4762e95ab40f6492c0c2968345bf528d15570667/supervertaler-3.7.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "1dd830b04b21e52b0551855febc53083e73f113e9035441e8147dd5d363bd81a",
                "md5": "3a032aaf98dd96a0685889ebb96dca33",
                "sha256": "5d1ff5191bcba94a716d6517c092102597f9d302334e7800e2714562bea59caf"
            },
            "downloads": -1,
            "filename": "supervertaler-3.7.1.tar.gz",
            "has_sig": false,
            "md5_digest": "3a032aaf98dd96a0685889ebb96dca33",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.12",
            "size": 2767853,
            "upload_time": "2025-10-20T21:10:54",
            "upload_time_iso_8601": "2025-10-20T21:10:54.914348Z",
            "url": "https://files.pythonhosted.org/packages/1d/d8/30b04b21e52b0551855febc53083e73f113e9035441e8147dd5d363bd81a/supervertaler-3.7.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-10-20 21:10:54",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "michaelbeijer",
    "github_project": "Supervertaler",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "supervertaler"
}
        
Elapsed time: 1.91648s