---
id: translate-toolkit
version: "3.19.17"
license: GPL-3.0-or-later
license_treatment: copyleft
maintenance: active
---

# translate-toolkit — Tools and API for translation and localization engineering.

License: copyleft · Maintenance: active · Downloads: 402.4K/mo

## What it is and what it does

Translate Toolkit is a Python library and command-line suite for localization engineers to work with translation files. It handles format conversion (PO, XLIFF, properties, Qt .ts, TMX, TBX, CSV, and many others), quality assurance checks, terminology extraction, and translation memory operations. The core is a set of Python classes for reading and writing localization storage formats, plus scripts that wrap them for common workflows like converting OpenOffice GSI to PO, merging corrected translations, or extracting terminology from PO files.

The package is designed to reduce repetitive work in localization pipelines. It runs on modern Python versions (3.11 through 3.14) and depends on lxml for XML handling and unicode-segmentation-rs for language-aware text segmentation. Optional dependencies add support for specific formats (Markdown, YAML, iCalendar) and features (spellcheck, fuzzy matching). The toolkit is actively maintained, part of the Translate project, and widely used in localization workflows.

Use it for:

- Convert translation files between formats (e.g., PO to XLIFF, Qt .ts to PO) to work in standard translation tools.
- Run quality assurance checks on PO files to find pattern violations, terminology inconsistencies, or language-specific issues.
- Batch process localization files to count translatable strings, extract terminology, or segment translations for memory creation.
- Merge corrected translations from QA tools back into existing PO files without manual re-editing.
- Build custom localization workflows by importing Python classes to handle new formats or project-specific logic.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Translate Toolkit converts, validates, and manipulates localization files across formats like PO, XLIFF, properties, and many others, with command-line tools and Python APIs for format conversion and quality assurance.

Yes. Translate Toolkit is actively maintained, has no known vulnerabilities, low install friction, and is the standard choice for localization engineers needing format conversion and QA tooling. The GPL-3.0-or-later license is a hard constraint only if you need to distribute proprietary software; for internal use or open-source projects, it poses no barrier. Install it if you work with translation files or build localization pipelines.

## Install

pip install translate-toolkit
uv add translate-toolkit
poetry add translate-toolkit

## Installing translate-toolkit

Before you install: Low install friction with a pure-wheel distribution. Active maintenance with a release 14 days ago and ongoing commits. Requires Python 3.11 or newer and two runtime dependencies (lxml and unicode-segmentation-rs); optional extras available for format-specific features.

License in practice: Released under GPL-3.0-or-later (copyleft). Any derivative work or distribution must also be open-source under a compatible license; proprietary projects using this toolkit must comply with GPL obligations or seek an alternative license.

Quickstart:

pip install translate-toolkit

from translate.storage import po

store = po.pofile()
unit = store.addsourceunit('Hello')
unit.target = 'Hola'
store.savefile('output.po')

Requires Python 3.11 or newer. The lxml and unicode-segmentation-rs dependencies must be installed (included by default); some optional format support requires additional extras (e.g., pip install translate-toolkit[markdown,yaml]).

Verify before relying:

- Whether the 40+ quality assurance checks mentioned in the description are all accessible via the pofilter command or require additional setup.
- Performance characteristics when processing very large localization files or batch conversions.
- Compatibility of optional extras (chardet, fluent, ical, ini, levenshtein, markdown, php, rc, spellcheck, subtitles, toml, yaml) with the current Python 3.11+ requirement.

## Package facts

- License: GPL-3.0-or-later (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 402.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

localization file converter, po xliff translation format, gettext translation tools, i18n l10n toolkit, translation file quality assurance, localization format converter, translation memory tools, localization, translation-tools, format-conversion

[View on SkillFed](https://skillfed.io/packages/translate-toolkit) · [View on PyPI](https://pypi.org/project/translate-toolkit/)