translators

library6.0.4pypypi✓ verified 89d ago

A Python library for free, multiple, and enjoyable translations. Version 6.0.4 supports over 50 translation services including Google, Bing, DeepL, and Yandex. Active development with frequent updates.

llm-agents http-networking data

pip install translators

github ↗package ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · TRANSLATORS

translators

llm-agentspythonv6.0.4

Install

13.2s avg

Import

2246ms

Disk

132MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v6.0.4 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 13.2s · import 2.246s · 125MB

132MB installed

● package 132MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

translators

✓ import translators as ts

✗ from translators import *

Use 'import translators as ts' to avoid name conflicts and access all functions.

Basic usage: translate text with a specified service and language codes.

import translators as ts # Translate text from English to Chinese translation = ts.translate_text('Hello, world!', translator='google', from_language='en', to_language='zh') print(translation) # List available translators print(ts.translators_pool())

translators --version

Debug

Known issues

breakingIn version 6.0, the function signature changed: 'translator' parameter renamed from 'translator' (was 'engine' in v5). Also 'from_language' and 'to_language' replaced 'from_lang' and 'to_lang'.

fix

Update function calls to use new parameter names: translator, from_language, to_language.

affects: <6.0

gotchaSome translators (e.g., Google) may rate-limit or block requests. Use sleep delays or proxies to avoid issues.

fix

Add time.sleep(1) between requests or use a rotating proxy list.

affects: all

gotchaNot all translators support all language pairs. Check supported languages with ts.get_languages(translator_name).

fix

Verify language support before translating.

affects: all

deprecatedThe 'translators' parameter 'sleep_seconds' is deprecated in favor of setting delays manually.

fix

Use time.sleep() instead.

affects: >=6.0

Errors

Common errors & fixes

KeyError: 'translation'

The translation failed due to an unsupported language pair or service unavailability.

fix

Check the translator name and language codes; use try/except to handle failures.

ModuleNotFoundError: No module named 'translators'

The library is not installed in the current Python environment.

fix

Run 'pip install translators' in your terminal or environment.

TypeError: translate_text() got an unexpected keyword argument 'engine'

Using old parameter name 'engine' which was renamed to 'translator' in v6.

fix

Replace 'engine=' with 'translator=' and 'from_lang=' with 'from_language=', 'to_lang=' with 'to_language='.

Upgrade

Version history

6.0.4latest on PyPI · released Jan 21, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

49 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/UlionTse/translators ↗

packagehttps://pypi.org/project/translators/ ↗

docshttps://github.com/UlionTse/translators/blob/master/README.md ↗

changeloghttps://github.com/UlionTse/translators/blob/master/change_log.md ↗