Skip to content
Back to top
View this page
Edit this page

# Installation

This is a guide to installing the Translate Toolkit on your system. If the Translate Toolkit is already packaged for your system, this is probably the easiest way to install it. For several Linux distributions, the package might be available through your package manager.

If your system already has the toolkit prepackaged, then please let us know what steps are required to install it.

## Download

The recommended installation is using uv or pip in a virtual environment.

    uv pip install translate-toolkit

You can also download a stable released version and install it manually.

For those who need problems fixed, or who want to work on the bleeding edge, get the latest source from Git.

## Installing packaged versions

Many Linux distributions come with translate-toolkit packaged, use your distribution command to install it:

On Debian (if you are on etch), just type the following command:

    # Debian / Ubuntu
    apt install translate-toolkit

    # Fedora / RedHat
    dnf install translate-toolkit

    # openSUSE
    zypper install translate-toolkit

## Installing on Windows

On Windows we recommend using uv to install Translate Toolkit. This automatically manages virtual environments for you.

1. Install latest Python 3.10+

2. Install uv by running in PowerShell:

       powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

3. Create a project directory and install:

       > mkdir translate-work
       > cd translate-work
       > uv venv
       > uv pip install translate-toolkit

4. Activate the environment and verify:

       > .venv\Scripts\activate
       > po2prop --version

Next times you need to use Translate Toolkit:

1. Navigate to your project directory

2. Activate the virtual environment: `.venv\Scripts\activate` (Command Prompt) or `.venv\Scripts\Activate.ps1` (PowerShell)

3. Run the Translate Toolkit commands you want

## Installing from Git

If you want to try the bleeding edge, or just want to have the latest fixes from a stabilising branch then you need to use Git to get your sources:

    $ git clone https://github.com/translate/translate.git
    $ cd translate

This will retrieve the `master` branch of the Toolkit. Further Git instructions are also available.

For users wanting to install from source:

    $ uv pip install .

For developers wanting to contribute:

    $ uv sync --all-extras --dev

This sets up a complete development environment with all dependencies. See the contributing guide for more details.

## Verify installed version

To verify which version of the toolkit you have installed run:

    $ prop2po --version
    prop2po 3.18.1