<p align="center">
<img src="https://github.com/UlionTse/translators/blob/master/docs/translators_logo.png" width="500"/>
</p>
<p align="center">
<a href="https://pypi.org/project/translators"><img alt="PyPI - Version" src="https://img.shields.io/pypi/v/translators.svg?color=blue"></a>
<a href="https://anaconda.org/conda-forge/translators"><img alt="Conda - Version" src="https://img.shields.io/conda/vn/conda-forge/translators.svg?color=blue"></a>
<a href="https://pypi.org/project/translators"><img alt="PyPI - License" src="https://img.shields.io/pypi/l/translators.svg?color=brightgreen"></a>
<a href="https://pypi.org/project/translators"><img alt="PyPI - Python" src="https://img.shields.io/pypi/pyversions/translators.svg?color=blue"></a>
<a href="https://pypi.org/project/translators"><img alt="PyPI - Status" src="https://img.shields.io/pypi/status/translators.svg?color=brightgreen"></a>
<a href="https://pypi.org/project/translators"><img alt="PyPI - Wheel" src="https://img.shields.io/badge/wheel-yes-brightgreen.svg"></a>
<a href="https://pypi.org/project/translators"><img alt="PyPI - Downloads" src="https://static.pepy.tech/personalized-badge/translators?period=total&units=international_system&left_text=downloads&left_color=grey&right_color=blue"></a>
</p>
* * *
**Translators** is a library that aims to bring **free, multiple, enjoyable** translations to individuals and students in Python.
- [Supported Translation Services](#supported-translation-services)
- [Installation](#installation)
- [Getting Started](#getting-started)
- [Supported Languages](#supported-languages)
- [Debug Tips](#debug-tips)
- [Star History](#star-history)
## Supported Translation Services
| ID | Translator | Number of Supported Languages | Advantage | Service | Status |
| --- | --------------------------------------------------------------------------------- | ----------------------------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------------------- |
| 1 | [Niutrans](https://niutrans.com/trans) | 452 | support the most languages in the world | [Northeastern University](http://english.neu.edu.cn/) / [Niutrans](https://github.com/NiuTrans), China | / |
| 2 | [MyMemory](https://mymemory.translated.net) | 330 | support the most languages in the world | [Translated](https://translatedlabs.com/welcome), Italy | stable |
| 3 | [Alibaba](https://translate.alibaba.com) | 221 | support most languages, support professional field | [Alibaba](https://damo.alibaba.com/about?lang=en), China | stable |
| 4 | [Baidu](https://fanyi.baidu.com) | 201 | support most languages, support professional field, support classical Chinese | [Baidu](https://ir.baidu.com/company-overview), China | stable |
| 5 | [ModernMt](https://www.modernmt.com/translate) | 200 | open-source, support more languages in the world | [Modernmt](https://github.com/modernmt) / [Translated](https://translatedlabs.com/welcome), Italy | stable |
| 6 | [VolcEngine](https://translate.volcengine.com) | 189 | support more languages in the world, support professional field | [ByteDance](https://www.bytedance.com/en/), China | / |
| 7 | [Iciba](https://www.iciba.com/fy) | 187 | support the most languages in the world | [Kingsoft](https://www.wps.com/about-us/) / [Xiaomi](https://www.mi.com/us/about/), China | stable |
| 8 | [Iflytek](https://fanyi.xfyun.cn/console/trans/text) | 137 | support the most languages in the world | [Iflytek](https://www.iflytek.com/en/about-us/about.html), China | / |
| 9 | [Google](https://translate.google.com) | 134 | support more languages in the world | [Google](https://about.google/), America | stable(offline in China inland) |
| 10 | [Bing](https://www.bing.com/Translator) | 128 | support more languages in the world | [Microsoft](https://www.microsoft.com/en-us/about), America | stable |
| 11 | [Lingvanex](https://lingvanex.com/demo) | 112 | support translation of different regions but the same language | [Lingvanex](https://lingvanex.com/about-us/), Cyprus | stable |
| 12 | [Yandex](https://translate.yandex.com) | 102 | support more languages in the world, support word to emoji | [Yandex](https://yandex.com/company/), Russia | stable |
| 13 | [Itranslate](https://itranslate.com/webapp) | 101 | support translation of different regions but the same language, such as en-US, en-UK, en-AU | [Itranslate](https://itranslate.com/about), Austria | stable |
| 14 | [SysTran](https://www.systransoft.com/translate/) | 52 | support more languages in the world | [SysTran](https://www.systransoft.com/systran/), France | stable |
| 15 | [Argos](https://libretranslate.com) | 46 | open-source | [Argos](https://github.com/argosopentech) / [Libre](https://github.com/LibreTranslate), America | stable |
| 16 | [Apertium](https://www.apertium.org/) | 45 | open-source | [Apertium](https://github.com/apertium), Spain | stable |
| 17 | [Reverso](https://www.reverso.net/text-translation) | 42 | popular on Mac and Iphone | [Reverso](https://www.corporate-translation.reverso.com/about-us), France | stable |
| 18 | [Deepl](https://www.deepl.com/translator) | 30 | high quality to translate but response slowly | [Deepl](https://jobs.deepl.com/l/en), Germany | stable |
| 19 | [CloudTranslation](https://www.cloudtranslation.com/#/translate) | 28 | support main languages | [Xiamen University](http://nlp.xmu.edu.cn/) / [CloudTranslation](https://www.cloudtranslation.com/#/about), China | stable |
| 20 | [QQTranSmart](https://transmart.qq.com) | 22 | support main languages | [Tencent](https://www.tencent.com/en-us/about.html), China | stable |
| 21 | [TranslateCom](https://www.translate.com/machine-translation) | 21 | good at English translation | [TranslateCom](https://www.translate.com/about-us), America | stable |
| 22 | [Sogou](https://fanyi.sogou.com/text) | 20 | support more languages in the world | [Tencent](https://www.tencent.com/en-us/about.html), China | stable |
| 23 | [Tilde](https://translate.tilde.com/) | 20 | good at lv, de, fr translation | [Tilde](https://tilde.com/about), Latvia | / |
| 24 | [Caiyun](https://fanyi.caiyunapp.com) | 19 | high quality to translate but response slowly, support professional field | [ColorfulClouds](http://caiyunapp.com/jobs/), China | stable |
| 25 | [QQFanyi](https://fanyi.qq.com) | 17 | support main languages | [Tencent](https://www.tencent.com/en-us/about.html), China | / |
| 26 | [TranslateMe](https://translateme.network/) | 16 | good at English translation | [TranslateMe](https://translateme.network/our-team/) / [Neosus](https://neosus.net/about/), Lithuania | / |
| 27 | [Papago](https://papago.naver.com) | 15 | good at Korean translation | [Naver](https://www.navercorp.com/en/naver/company), South Korea | stable |
| 28 | [Mirai](https://miraitranslate.com/trial/) | 15 | good at Japanese translation | [MiraiTranslate](https://miraitranslate.com/en/company/), Japan | / |
| 29 | [Youdao](https://ai.youdao.com/product-fanyi-text.s) | 12 | support main languages, high quality | [Netease](https://ir.netease.com/company-overview/corporate-profile), China | stable |
| 30 | [Iflyrec](https://fanyi.iflyrec.com) | 12 | good at Chinese translation | [Iflytek](https://www.iflytek.com/en/about-us/about.html), China | stable |
| 31 | [Hujiang](https://dict.hjenglish.com/app/trans) | 12 | supported by baidu | [Hujiang](https://www.hujiang.com/about/intro), China | stable |
| 32 | [Yeekit](https://www.yeekit.com/site/translate) | 10 | support main languages | [CTC](https://www.ctpc.com.cn/cms/enAboutUs.htm), China | / |
| 33 | [LanguageWire](https://www.languagewire.com/en/technology/languagewire-translate) | 8 | good at English translation | [LanguageWire](https://www.languagewire.com/about-us), Denmark | stable |
| 34 | [Elia](https://elia.eus/translator) | 6 | good at Basque translation | [Elhuyar](https://www.elhuyar.eus/eu/nor-gara), Spain | stable |
| 35 | [Judic](https://judic.io/en/translate) | 4 | good at European translation | [CrossLang](https://crosslang.com/about-us/), Belgium | / |
| 36 | [Mglip](http://fy.mglip.com/pc) | 3 | good at Mongolia translation | [Inner Mongolia University](https://www.imu.edu.cn/yw/Home.htm), China | stable |
| 37 | [Utibet](http://mt.utibet.edu.cn/mt) | 2 | good at Tibet translation | [Tibet University](http://www.utibet.edu.cn/), China | stable |
## Installation
```sh
# PYPI
pip install --upgrade translators
# Conda
conda install conda-forge::translators
# Source
git clone https://github.com/UlionTse/translators.git
cd translators
python setup.py install
```
## Getting Started
```python
import translators as ts
q_text = '季姬寂,集鸡,鸡即棘鸡。棘鸡饥叽,季姬及箕稷济鸡。'
q_html = '''<!DOCTYPE html><html><head><title>《季姬击鸡记》</title></head><body><p>还有另一篇文章《施氏食狮史》。</p></body></html>'''
### usage
_ = ts.preaccelerate_and_speedtest() # Optional. Caching sessions in advance, which can help improve access speed.
print(ts.translators_pool)
print(ts.translate_text(q_text))
print(ts.translate_html(q_html, translator='alibaba'))
### parameters
help(ts.translate_text)
"""
translate_text(query_text: str, translator: str = 'bing', from_language: str = 'auto', to_language: str = 'en', **kwargs) -> Union[str, dict]
:param query_text: str, must.
:param translator: str, default 'bing'.
:param from_language: str, default 'auto'.
:param to_language: str, default 'en'.
:param if_use_preacceleration: bool, default False.
:param **kwargs:
:param is_detail_result: bool, default False.
:param professional_field: str, default None. Support alibaba(), baidu(), caiyun(), cloudTranslation(), elia(), sysTran(), youdao(), volcEngine() only.
:param timeout: float, default None.
:param proxies: dict, default None.
:param sleep_seconds: float, default 0.
:param update_session_after_freq: int, default 1000.
:param update_session_after_seconds: float, default 1500.
:param if_use_cn_host: bool, default False. Support google(), bing() only.
:param reset_host_url: str, default None. Support google(), yandex() only.
:param if_check_reset_host_url: bool, default True. Support google(), yandex() only.
:param if_ignore_empty_query: bool, default False.
:param limit_of_length: int, default 20000.
:param if_ignore_limit_of_length: bool, default False.
:param if_show_time_stat: bool, default False.
:param show_time_stat_precision: int, default 2.
:param if_print_warning: bool, default True.
:param lingvanex_mode: str, default 'B2C', choose from ("B2C", "B2B").
:param myMemory_mode: str, default "web", choose from ("web", "api").
:return: str or dict
"""
```
## Supported Languages
| Language | Language of Translator | [Google](https://translate.google.com) | [Yandex](https://translate.yandex.com) | [Bing](https://www.bing.com/Translator) | [Baidu](https://fanyi.baidu.com) | [Alibaba](https://translate.alibaba.com) | [Tencent](https://fanyi.qq.com) | [Youdao](https://fanyi.youdao.com) | [Sogou](https://fanyi.sogou.com) | [Deepl](https://www.deepl.com/translator) | [Caiyun](https://fanyi.caiyunapp.com) | [Argos](https://translate.argosopentech.com) | others... |
| -------------------- | ---------------------- | -------------------------------------- | -------------------------------------- | --------------------------------------- | -------------------------------- | ---------------------------------------- | ------------------------------- | ---------------------------------- | -------------------------------- | ----------------------------------------- | ------------------------------------- | -------------------------------------------- | --------- |
| english | en | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | ... |
| chinese | zh | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | |
| arabic | ar | Y | Y | Y | Y(ara) | Y | Y | Y | Y | | | Y | |
| russian | ru | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | |
| french | fr | Y | Y | Y | Y(fra) | Y | Y | Y | Y | Y | Y | Y | |
| german | de | Y | Y | Y | Y | | Y | Y | Y | Y | | Y | |
| spanish | es | Y | Y | Y | Y(spa) | Y | Y | Y | Y | Y | Y | Y | |
| portuguese | pt | Y | Y | Y(pt/pt-pt) | Y | Y | Y | Y | Y | Y | | Y | |
| italian | it | Y | Y | Y | Y | Y | Y | Y | Y | Y | | Y | |
| japanese | ja | Y | Y | Y | Y(jp) | | Y | Y | Y | Y | Y | Y | |
| korean | ko | Y | Y | Y | Y(kor) | | Y | Y | Y | | | Y | |
| greek | el | Y | Y | Y | Y | | | | Y | Y | | | |
| dutch | nl | Y | Y | Y | Y | | | Y | Y | Y | | | |
| hindi | hi | Y | Y | Y | | | Y | | Y | | | Y | |
| turkish | tr | Y | Y | Y | | Y | Y | | Y | | | Y | |
| malay | ms | Y | Y | Y | | | Y | | Y | | | | |
| thai | th | Y | Y | Y | Y | Y | Y | | Y | | | | |
| vietnamese | vi | Y | Y | Y | Y(vie) | Y | Y | Y | Y | | | Y | |
| indonesian | id | Y | Y | Y | | Y | Y | Y | Y | | | Y | |
| hebrew | he | Y(iw) | Y | Y | | | | | Y | | | | |
| polish | pl | Y | Y | Y | Y | | | | Y | Y | | Y | |
| mongolian | mn | Y | Y | | | | | | | | | | |
| czech | cs | Y | Y | Y | Y | | | | Y | Y | | | |
| hungarian | hu | Y | Y | Y | Y | | | | Y | Y | | | |
| estonian | et | Y | Y | Y | Y(est) | | | | Y | Y | | | |
| bulgarian | bg | Y | Y | Y | Y(bul) | | | | Y | Y | | | |
| danish | da | Y | Y | Y | Y(dan) | | | | Y | Y | | | |
| finnish | fi | Y | Y | Y | Y(fin) | | | | Y | Y | | | |
| romanian | ro | Y | Y | Y | Y(rom) | | | | Y | Y | | | |
| swedish | sv | Y | Y | Y | Y(swe) | | | | Y | Y | | | |
| slovenian | sl | Y | Y | Y | Y(slo) | | | | Y | Y | | | |
| persian/farsi | fa | Y | Y | Y | | | | | Y | | | | |
| bosnian | bs | Y | Y | Y(bs-Latn) | | | | | Y(bs-Latn) | | | | |
| serbian | sr | Y | Y | Y(sr-Latn/sr-Cyrl) | | | | | Y(sr-Latn/sr-Cyrl) | | | | |
| fijian | fj | | | Y | | | | | Y | | | | |
| filipino | tl | Y | Y | Y(fil) | | | | | Y(fil) | | | | |
| haitiancreole | ht | Y | Y | Y | | | | | Y | | | | |
| catalan | ca | Y | Y | Y | | | | | Y | | | | |
| croatian | hr | Y | Y | Y | | | | | Y | | | | |
| latvian | lv | Y | Y | Y | | | | | Y | Y | | | |
| lithuanian | lt | Y | Y | Y | | | | | Y | Y | | | |
| urdu | ur | Y | Y | Y | | | | | Y | | | | |
| ukrainian | uk | Y | Y | Y | | | | | Y | | | | |
| welsh | cy | Y | Y | Y | | | | | Y | | | | |
| tahiti | ty | | | Y | | | | | Y | | | | |
| tongan | to | | | Y | | | | | Y | | | | |
| swahili | sw | Y | Y | Y | | | | | Y | | | | |
| samoan | sm | Y | | Y | | | | | Y | | | | |
| slovak | sk | Y | Y | Y | | | | | Y | Y | | | |
| afrikaans | af | Y | Y | Y | | | | | Y | | | | |
| norwegian | no | Y | Y | Y | | | | | Y | | | | |
| bengali | bn | Y | Y | Y(bn-BD) | | | | | Y | | | | |
| malagasy | mg | Y | Y | Y | | | | | Y | | | | |
| maltese | mt | Y | Y | Y | | | | | Y | | | | |
| queretaro otomi | otq | | | Y | | | | | Y | | | | |
| klingon/tlhingan hol | tlh | | | Y | | | | | Y | | | | |
| gujarati | gu | Y | Y | Y | | | | | | | | | |
| tamil | ta | Y | Y | Y | | | | | | | | | |
| telugu | te | Y | Y | Y | | | | | | | | | |
| punjabi | pa | Y | Y | Y | | | | | | | | | |
| amharic | am | Y | Y | | | | | | | | | | |
| azerbaijani | az | Y | Y | | | | | | | | | | |
| bashkir | ba | | Y | | | | | | | | | | |
| belarusian | be | Y | Y | | | | | | | | | | |
| cebuano | ceb | Y | Y | | | | | | | | | | |
| chuvash | cv | | Y | | | | | | | | | | |
| esperanto | eo | Y | Y | | | | | | | | | | |
| basque | eu | Y | Y | | | | | | | | | | |
| irish | ga | Y | Y | Y | | | | | | | | | |
| emoji | emj | | Y | | | | | | | | | | |
| ... | ... | | | | | | | | | | | | |
### About Chinese Language
| Language | Language of Translator | [Google](https://translate.google.com) | [Yandex](https://translate.yandex.com) | [Bing](https://www.bing.com/Translator) | [Baidu](https://fanyi.baidu.com) | [Alibaba](https://translate.alibaba.com) | [Tencent](https://fanyi.qq.com) | [Youdao](https://fanyi.youdao.com) | [Sogou](https://fanyi.sogou.com) | [Iciba](https://www.iciba.com/fy) | [Iflytek](https://fanyi.xfyun.cn/console/trans/text) | [Caiyun](https://fanyi.caiyunapp.com) | [Deepl](https://www.deepl.com/translator) | [Argos](https://translate.argosopentech.com) | [Itranslate](https://itranslate.com/webapp) | [Reverso](https://www.reverso.net/text-translation) | [TranslateCom](https://www.translate.com/machine-translation) | [Papago](https://papago.naver.com) | [Utibet](http://mt.utibet.edu.cn/mt) |
| ------------- | ---------------------- | -------------------------------------- | -------------------------------------- | --------------------------------------- | -------------------------------- | ---------------------------------------- | ------------------------------- | ---------------------------------- | -------------------------------- | --------------------------------- | ---------------------------------------------------- | ------------------------------------- | ----------------------------------------- | -------------------------------------------- | ------------------------------------------- | --------------------------------------------------- | ------------------------------------------------------------- | ---------------------------------- | ------------------------------------ |
| Chinese(简体) | zh-CHS | Y(zh-CN) | Y(zh) | Y(zh-Hans) | Y(zh) | Y(zh) | Y(zh) | Y | Y | Y(zh) | Y(zh) | Y(zh) | Y(zh) | Y(zh) | Y(zh-CN) | Y(zh/chi) | ... | Y(zh-CN) | Y(zh) |
| Chinese(繁体) | zh-CHT | Y(zh-TW) | | Y(zh-Hant) | Y(cht) | Y(zh-TW) | | | Y | Y(cnt) | | | | | Y(zh-TW) | | | Y(zh-TW) | |
| Chinese(文言文) | wyw | | | | Y | | | | | | | | | | | | | | |
| Chinese(粤语) | yue | | | Y | Y | | | | Y | Y | Y | | | | Y(zh-HK) | | | | |
| Chinese(内蒙语) | mn | N[外蒙] | N[外蒙] | | | | | | | | Y[内蒙] | | | | N[外蒙] | | | | |
| Chinese(维吾尔语) | uy | | | | | | | | | Y | | | | | | | | | |
| Chinese(藏语) | ti | | | | | | | | | Y | | | | | | | | | Y |
| Chinese(白苗文) | mww | | | Y | | | | | Y | Y | | | | | | | | | |
| Chinese(彝语) | ii | | | | | | | | | | Y | | | | | | | | |
| Chinese(苗语) | hmn | | | | | | | | | | | | | | Y | | | | |
| Chinese(壮语) | zyb | | | | | | | | | | | | | | | | | | |
## Debug Tips
### Linux Runtime Environment
1. To support javascript runtime environment, you should [download and install Node.js](https://nodejs.org/en/download/).
2. Function baidu() doesn't work on Linux without desktop.
### HttpError 4xx
1. Check whether you made high frequency requests, especially httperror 429.
2. Check whether this service is provided in your region.
3. Detail to solve [HttpError](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status) itself.
4. [Issue me](https://github.com/UlionTse/translators/issues), thanks.
### NetworkError or ProxyError
1. Check whether the network is connected correctly.
2. Check the proxy are enabled on your computer. If it is enabled, try turning it off or otherwise.
## Star History
[![Star History Chart](https://api.star-history.com/svg?repos=UlionTse/translators&type=Date)](https://star-history.com/#UlionTse/translators&Date)
Raw data
{
"_id": null,
"home_page": "https://github.com/uliontse/translators",
"name": "translators",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "translate, translate_text, translate_html, alibaba, apertium, argos, baidu, bing, caiyun, cloudTranslation, deepl, elia, google, hujiang, iciba, iflytek, iflyrec, itranslate, judic, languageWire, lingvanex, mglip, mirai, modernMt, myMemory, niutrans, papago, qqFanyi, qqTranSmart, reverso, sogou, sysTran, tilde, translateCom, translateMe, utibet, volcEngine, yandex, yeekit, youdao",
"author": "UlionTse",
"author_email": "uliontse@outlook.com",
"download_url": "https://files.pythonhosted.org/packages/85/de/f81a8796bd75f4780c7cf2149e7e419bbd1666fed483979942a8c47e6e4a/translators-5.9.3.tar.gz",
"platform": null,
"description": "<p align=\"center\">\r\n <img src=\"https://github.com/UlionTse/translators/blob/master/docs/translators_logo.png\" width=\"500\"/>\r\n</p>\r\n<p align=\"center\">\r\n <a href=\"https://pypi.org/project/translators\"><img alt=\"PyPI - Version\" src=\"https://img.shields.io/pypi/v/translators.svg?color=blue\"></a>\r\n <a href=\"https://anaconda.org/conda-forge/translators\"><img alt=\"Conda - Version\" src=\"https://img.shields.io/conda/vn/conda-forge/translators.svg?color=blue\"></a>\r\n <a href=\"https://pypi.org/project/translators\"><img alt=\"PyPI - License\" src=\"https://img.shields.io/pypi/l/translators.svg?color=brightgreen\"></a>\r\n <a href=\"https://pypi.org/project/translators\"><img alt=\"PyPI - Python\" src=\"https://img.shields.io/pypi/pyversions/translators.svg?color=blue\"></a>\r\n <a href=\"https://pypi.org/project/translators\"><img alt=\"PyPI - Status\" src=\"https://img.shields.io/pypi/status/translators.svg?color=brightgreen\"></a>\r\n <a href=\"https://pypi.org/project/translators\"><img alt=\"PyPI - Wheel\" src=\"https://img.shields.io/badge/wheel-yes-brightgreen.svg\"></a>\r\n <a href=\"https://pypi.org/project/translators\"><img alt=\"PyPI - Downloads\" src=\"https://static.pepy.tech/personalized-badge/translators?period=total&units=international_system&left_text=downloads&left_color=grey&right_color=blue\"></a>\r\n</p>\r\n\r\n* * *\r\n\r\n**Translators** is a library that aims to bring **free, multiple, enjoyable** translations to individuals and students in Python. \r\n\r\n- [Supported Translation Services](#supported-translation-services)\r\n- [Installation](#installation)\r\n- [Getting Started](#getting-started)\r\n- [Supported Languages](#supported-languages)\r\n- [Debug Tips](#debug-tips)\r\n- [Star History](#star-history)\r\n\r\n## Supported Translation Services\r\n\r\n| ID | Translator | Number of Supported Languages | Advantage | Service | Status |\r\n| --- | --------------------------------------------------------------------------------- | ----------------------------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------------------- |\r\n| 1 | [Niutrans](https://niutrans.com/trans) | 452 | support the most languages in the world | [Northeastern University](http://english.neu.edu.cn/) / [Niutrans](https://github.com/NiuTrans), China | / |\r\n| 2 | [MyMemory](https://mymemory.translated.net) | 330 | support the most languages in the world | [Translated](https://translatedlabs.com/welcome), Italy | stable |\r\n| 3 | [Alibaba](https://translate.alibaba.com) | 221 | support most languages, support professional field | [Alibaba](https://damo.alibaba.com/about?lang=en), China | stable |\r\n| 4 | [Baidu](https://fanyi.baidu.com) | 201 | support most languages, support professional field, support classical Chinese | [Baidu](https://ir.baidu.com/company-overview), China | stable |\r\n| 5 | [ModernMt](https://www.modernmt.com/translate) | 200 | open-source, support more languages in the world | [Modernmt](https://github.com/modernmt) / [Translated](https://translatedlabs.com/welcome), Italy | stable |\r\n| 6 | [VolcEngine](https://translate.volcengine.com) | 189 | support more languages in the world, support professional field | [ByteDance](https://www.bytedance.com/en/), China | / |\r\n| 7 | [Iciba](https://www.iciba.com/fy) | 187 | support the most languages in the world | [Kingsoft](https://www.wps.com/about-us/) / [Xiaomi](https://www.mi.com/us/about/), China | stable |\r\n| 8 | [Iflytek](https://fanyi.xfyun.cn/console/trans/text) | 137 | support the most languages in the world | [Iflytek](https://www.iflytek.com/en/about-us/about.html), China | / |\r\n| 9 | [Google](https://translate.google.com) | 134 | support more languages in the world | [Google](https://about.google/), America | stable(offline in China inland) |\r\n| 10 | [Bing](https://www.bing.com/Translator) | 128 | support more languages in the world | [Microsoft](https://www.microsoft.com/en-us/about), America | stable |\r\n| 11 | [Lingvanex](https://lingvanex.com/demo) | 112 | support translation of different regions but the same language | [Lingvanex](https://lingvanex.com/about-us/), Cyprus | stable |\r\n| 12 | [Yandex](https://translate.yandex.com) | 102 | support more languages in the world, support word to emoji | [Yandex](https://yandex.com/company/), Russia | stable |\r\n| 13 | [Itranslate](https://itranslate.com/webapp) | 101 | support translation of different regions but the same language, such as en-US, en-UK, en-AU | [Itranslate](https://itranslate.com/about), Austria | stable |\r\n| 14 | [SysTran](https://www.systransoft.com/translate/) | 52 | support more languages in the world | [SysTran](https://www.systransoft.com/systran/), France | stable |\r\n| 15 | [Argos](https://libretranslate.com) | 46 | open-source | [Argos](https://github.com/argosopentech) / [Libre](https://github.com/LibreTranslate), America | stable |\r\n| 16 | [Apertium](https://www.apertium.org/) | 45 | open-source | [Apertium](https://github.com/apertium), Spain | stable |\r\n| 17 | [Reverso](https://www.reverso.net/text-translation) | 42 | popular on Mac and Iphone | [Reverso](https://www.corporate-translation.reverso.com/about-us), France | stable |\r\n| 18 | [Deepl](https://www.deepl.com/translator) | 30 | high quality to translate but response slowly | [Deepl](https://jobs.deepl.com/l/en), Germany | stable |\r\n| 19 | [CloudTranslation](https://www.cloudtranslation.com/#/translate) | 28 | support main languages | [Xiamen University](http://nlp.xmu.edu.cn/) / [CloudTranslation](https://www.cloudtranslation.com/#/about), China | stable |\r\n| 20 | [QQTranSmart](https://transmart.qq.com) | 22 | support main languages | [Tencent](https://www.tencent.com/en-us/about.html), China | stable |\r\n| 21 | [TranslateCom](https://www.translate.com/machine-translation) | 21 | good at English translation | [TranslateCom](https://www.translate.com/about-us), America | stable |\r\n| 22 | [Sogou](https://fanyi.sogou.com/text) | 20 | support more languages in the world | [Tencent](https://www.tencent.com/en-us/about.html), China | stable |\r\n| 23 | [Tilde](https://translate.tilde.com/) | 20 | good at lv, de, fr translation | [Tilde](https://tilde.com/about), Latvia | / |\r\n| 24 | [Caiyun](https://fanyi.caiyunapp.com) | 19 | high quality to translate but response slowly, support professional field | [ColorfulClouds](http://caiyunapp.com/jobs/), China | stable |\r\n| 25 | [QQFanyi](https://fanyi.qq.com) | 17 | support main languages | [Tencent](https://www.tencent.com/en-us/about.html), China | / |\r\n| 26 | [TranslateMe](https://translateme.network/) | 16 | good at English translation | [TranslateMe](https://translateme.network/our-team/) / [Neosus](https://neosus.net/about/), Lithuania | / |\r\n| 27 | [Papago](https://papago.naver.com) | 15 | good at Korean translation | [Naver](https://www.navercorp.com/en/naver/company), South Korea | stable |\r\n| 28 | [Mirai](https://miraitranslate.com/trial/) | 15 | good at Japanese translation | [MiraiTranslate](https://miraitranslate.com/en/company/), Japan | / |\r\n| 29 | [Youdao](https://ai.youdao.com/product-fanyi-text.s) | 12 | support main languages, high quality | [Netease](https://ir.netease.com/company-overview/corporate-profile), China | stable |\r\n| 30 | [Iflyrec](https://fanyi.iflyrec.com) | 12 | good at Chinese translation | [Iflytek](https://www.iflytek.com/en/about-us/about.html), China | stable |\r\n| 31 | [Hujiang](https://dict.hjenglish.com/app/trans) | 12 | supported by baidu | [Hujiang](https://www.hujiang.com/about/intro), China | stable |\r\n| 32 | [Yeekit](https://www.yeekit.com/site/translate) | 10 | support main languages | [CTC](https://www.ctpc.com.cn/cms/enAboutUs.htm), China | / |\r\n| 33 | [LanguageWire](https://www.languagewire.com/en/technology/languagewire-translate) | 8 | good at English translation | [LanguageWire](https://www.languagewire.com/about-us), Denmark | stable |\r\n| 34 | [Elia](https://elia.eus/translator) | 6 | good at Basque translation | [Elhuyar](https://www.elhuyar.eus/eu/nor-gara), Spain | stable |\r\n| 35 | [Judic](https://judic.io/en/translate) | 4 | good at European translation | [CrossLang](https://crosslang.com/about-us/), Belgium | / |\r\n| 36 | [Mglip](http://fy.mglip.com/pc) | 3 | good at Mongolia translation | [Inner Mongolia University](https://www.imu.edu.cn/yw/Home.htm), China | stable |\r\n| 37 | [Utibet](http://mt.utibet.edu.cn/mt) | 2 | good at Tibet translation | [Tibet University](http://www.utibet.edu.cn/), China | stable |\r\n\r\n## Installation\r\n\r\n```sh\r\n# PYPI\r\npip install --upgrade translators\r\n\r\n# Conda\r\nconda install conda-forge::translators\r\n\r\n# Source\r\ngit clone https://github.com/UlionTse/translators.git\r\ncd translators\r\npython setup.py install\r\n```\r\n\r\n## Getting Started\r\n\r\n```python\r\nimport translators as ts\r\n\r\nq_text = '\u5b63\u59ec\u5bc2\uff0c\u96c6\u9e21\uff0c\u9e21\u5373\u68d8\u9e21\u3002\u68d8\u9e21\u9965\u53fd\uff0c\u5b63\u59ec\u53ca\u7b95\u7a37\u6d4e\u9e21\u3002'\r\nq_html = '''<!DOCTYPE html><html><head><title>\u300a\u5b63\u59ec\u51fb\u9e21\u8bb0\u300b</title></head><body><p>\u8fd8\u6709\u53e6\u4e00\u7bc7\u6587\u7ae0\u300a\u65bd\u6c0f\u98df\u72ee\u53f2\u300b\u3002</p></body></html>'''\r\n\r\n### usage\r\n_ = ts.preaccelerate_and_speedtest() # Optional. Caching sessions in advance, which can help improve access speed.\r\n\r\nprint(ts.translators_pool)\r\nprint(ts.translate_text(q_text))\r\nprint(ts.translate_html(q_html, translator='alibaba'))\r\n\r\n### parameters\r\nhelp(ts.translate_text)\r\n\r\n\"\"\"\r\ntranslate_text(query_text: str, translator: str = 'bing', from_language: str = 'auto', to_language: str = 'en', **kwargs) -> Union[str, dict]\r\n :param query_text: str, must.\r\n :param translator: str, default 'bing'.\r\n :param from_language: str, default 'auto'.\r\n :param to_language: str, default 'en'.\r\n :param if_use_preacceleration: bool, default False.\r\n :param **kwargs:\r\n :param is_detail_result: bool, default False.\r\n :param professional_field: str, default None. Support alibaba(), baidu(), caiyun(), cloudTranslation(), elia(), sysTran(), youdao(), volcEngine() only.\r\n :param timeout: float, default None.\r\n :param proxies: dict, default None.\r\n :param sleep_seconds: float, default 0.\r\n :param update_session_after_freq: int, default 1000.\r\n :param update_session_after_seconds: float, default 1500.\r\n :param if_use_cn_host: bool, default False. Support google(), bing() only. \r\n :param reset_host_url: str, default None. Support google(), yandex() only.\r\n :param if_check_reset_host_url: bool, default True. Support google(), yandex() only.\r\n :param if_ignore_empty_query: bool, default False.\r\n :param limit_of_length: int, default 20000.\r\n :param if_ignore_limit_of_length: bool, default False.\r\n :param if_show_time_stat: bool, default False.\r\n :param show_time_stat_precision: int, default 2.\r\n :param if_print_warning: bool, default True.\r\n :param lingvanex_mode: str, default 'B2C', choose from (\"B2C\", \"B2B\").\r\n :param myMemory_mode: str, default \"web\", choose from (\"web\", \"api\").\r\n :return: str or dict\r\n\"\"\"\r\n```\r\n\r\n## Supported Languages\r\n\r\n| Language | Language of Translator | [Google](https://translate.google.com) | [Yandex](https://translate.yandex.com) | [Bing](https://www.bing.com/Translator) | [Baidu](https://fanyi.baidu.com) | [Alibaba](https://translate.alibaba.com) | [Tencent](https://fanyi.qq.com) | [Youdao](https://fanyi.youdao.com) | [Sogou](https://fanyi.sogou.com) | [Deepl](https://www.deepl.com/translator) | [Caiyun](https://fanyi.caiyunapp.com) | [Argos](https://translate.argosopentech.com) | others... |\r\n| -------------------- | ---------------------- | -------------------------------------- | -------------------------------------- | --------------------------------------- | -------------------------------- | ---------------------------------------- | ------------------------------- | ---------------------------------- | -------------------------------- | ----------------------------------------- | ------------------------------------- | -------------------------------------------- | --------- |\r\n| english | en | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | ... |\r\n| chinese | zh | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | |\r\n| arabic | ar | Y | Y | Y | Y(ara) | Y | Y | Y | Y | | | Y | |\r\n| russian | ru | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | |\r\n| french | fr | Y | Y | Y | Y(fra) | Y | Y | Y | Y | Y | Y | Y | |\r\n| german | de | Y | Y | Y | Y | | Y | Y | Y | Y | | Y | |\r\n| spanish | es | Y | Y | Y | Y(spa) | Y | Y | Y | Y | Y | Y | Y | |\r\n| portuguese | pt | Y | Y | Y(pt/pt-pt) | Y | Y | Y | Y | Y | Y | | Y | |\r\n| italian | it | Y | Y | Y | Y | Y | Y | Y | Y | Y | | Y | |\r\n| japanese | ja | Y | Y | Y | Y(jp) | | Y | Y | Y | Y | Y | Y | |\r\n| korean | ko | Y | Y | Y | Y(kor) | | Y | Y | Y | | | Y | |\r\n| greek | el | Y | Y | Y | Y | | | | Y | Y | | | |\r\n| dutch | nl | Y | Y | Y | Y | | | Y | Y | Y | | | |\r\n| hindi | hi | Y | Y | Y | | | Y | | Y | | | Y | |\r\n| turkish | tr | Y | Y | Y | | Y | Y | | Y | | | Y | |\r\n| malay | ms | Y | Y | Y | | | Y | | Y | | | | |\r\n| thai | th | Y | Y | Y | Y | Y | Y | | Y | | | | |\r\n| vietnamese | vi | Y | Y | Y | Y(vie) | Y | Y | Y | Y | | | Y | |\r\n| indonesian | id | Y | Y | Y | | Y | Y | Y | Y | | | Y | |\r\n| hebrew | he | Y(iw) | Y | Y | | | | | Y | | | | |\r\n| polish | pl | Y | Y | Y | Y | | | | Y | Y | | Y | |\r\n| mongolian | mn | Y | Y | | | | | | | | | | |\r\n| czech | cs | Y | Y | Y | Y | | | | Y | Y | | | |\r\n| hungarian | hu | Y | Y | Y | Y | | | | Y | Y | | | |\r\n| estonian | et | Y | Y | Y | Y(est) | | | | Y | Y | | | |\r\n| bulgarian | bg | Y | Y | Y | Y(bul) | | | | Y | Y | | | |\r\n| danish | da | Y | Y | Y | Y(dan) | | | | Y | Y | | | |\r\n| finnish | fi | Y | Y | Y | Y(fin) | | | | Y | Y | | | |\r\n| romanian | ro | Y | Y | Y | Y(rom) | | | | Y | Y | | | |\r\n| swedish | sv | Y | Y | Y | Y(swe) | | | | Y | Y | | | |\r\n| slovenian | sl | Y | Y | Y | Y(slo) | | | | Y | Y | | | |\r\n| persian/farsi | fa | Y | Y | Y | | | | | Y | | | | |\r\n| bosnian | bs | Y | Y | Y(bs-Latn) | | | | | Y(bs-Latn) | | | | |\r\n| serbian | sr | Y | Y | Y(sr-Latn/sr-Cyrl) | | | | | Y(sr-Latn/sr-Cyrl) | | | | |\r\n| fijian | fj | | | Y | | | | | Y | | | | |\r\n| filipino | tl | Y | Y | Y(fil) | | | | | Y(fil) | | | | |\r\n| haitiancreole | ht | Y | Y | Y | | | | | Y | | | | |\r\n| catalan | ca | Y | Y | Y | | | | | Y | | | | |\r\n| croatian | hr | Y | Y | Y | | | | | Y | | | | |\r\n| latvian | lv | Y | Y | Y | | | | | Y | Y | | | |\r\n| lithuanian | lt | Y | Y | Y | | | | | Y | Y | | | |\r\n| urdu | ur | Y | Y | Y | | | | | Y | | | | |\r\n| ukrainian | uk | Y | Y | Y | | | | | Y | | | | |\r\n| welsh | cy | Y | Y | Y | | | | | Y | | | | |\r\n| tahiti | ty | | | Y | | | | | Y | | | | |\r\n| tongan | to | | | Y | | | | | Y | | | | |\r\n| swahili | sw | Y | Y | Y | | | | | Y | | | | |\r\n| samoan | sm | Y | | Y | | | | | Y | | | | |\r\n| slovak | sk | Y | Y | Y | | | | | Y | Y | | | |\r\n| afrikaans | af | Y | Y | Y | | | | | Y | | | | |\r\n| norwegian | no | Y | Y | Y | | | | | Y | | | | |\r\n| bengali | bn | Y | Y | Y(bn-BD) | | | | | Y | | | | |\r\n| malagasy | mg | Y | Y | Y | | | | | Y | | | | |\r\n| maltese | mt | Y | Y | Y | | | | | Y | | | | |\r\n| queretaro otomi | otq | | | Y | | | | | Y | | | | |\r\n| klingon/tlhingan hol | tlh | | | Y | | | | | Y | | | | |\r\n| gujarati | gu | Y | Y | Y | | | | | | | | | |\r\n| tamil | ta | Y | Y | Y | | | | | | | | | |\r\n| telugu | te | Y | Y | Y | | | | | | | | | |\r\n| punjabi | pa | Y | Y | Y | | | | | | | | | |\r\n| amharic | am | Y | Y | | | | | | | | | | |\r\n| azerbaijani | az | Y | Y | | | | | | | | | | |\r\n| bashkir | ba | | Y | | | | | | | | | | |\r\n| belarusian | be | Y | Y | | | | | | | | | | |\r\n| cebuano | ceb | Y | Y | | | | | | | | | | |\r\n| chuvash | cv | | Y | | | | | | | | | | |\r\n| esperanto | eo | Y | Y | | | | | | | | | | |\r\n| basque | eu | Y | Y | | | | | | | | | | |\r\n| irish | ga | Y | Y | Y | | | | | | | | | |\r\n| emoji | emj | | Y | | | | | | | | | | |\r\n| ... | ... | | | | | | | | | | | | |\r\n\r\n### About Chinese Language\r\n\r\n| Language | Language of Translator | [Google](https://translate.google.com) | [Yandex](https://translate.yandex.com) | [Bing](https://www.bing.com/Translator) | [Baidu](https://fanyi.baidu.com) | [Alibaba](https://translate.alibaba.com) | [Tencent](https://fanyi.qq.com) | [Youdao](https://fanyi.youdao.com) | [Sogou](https://fanyi.sogou.com) | [Iciba](https://www.iciba.com/fy) | [Iflytek](https://fanyi.xfyun.cn/console/trans/text) | [Caiyun](https://fanyi.caiyunapp.com) | [Deepl](https://www.deepl.com/translator) | [Argos](https://translate.argosopentech.com) | [Itranslate](https://itranslate.com/webapp) | [Reverso](https://www.reverso.net/text-translation) | [TranslateCom](https://www.translate.com/machine-translation) | [Papago](https://papago.naver.com) | [Utibet](http://mt.utibet.edu.cn/mt) |\r\n| ------------- | ---------------------- | -------------------------------------- | -------------------------------------- | --------------------------------------- | -------------------------------- | ---------------------------------------- | ------------------------------- | ---------------------------------- | -------------------------------- | --------------------------------- | ---------------------------------------------------- | ------------------------------------- | ----------------------------------------- | -------------------------------------------- | ------------------------------------------- | --------------------------------------------------- | ------------------------------------------------------------- | ---------------------------------- | ------------------------------------ |\r\n| Chinese(\u7b80\u4f53) | zh-CHS | Y(zh-CN) | Y(zh) | Y(zh-Hans) | Y(zh) | Y(zh) | Y(zh) | Y | Y | Y(zh) | Y(zh) | Y(zh) | Y(zh) | Y(zh) | Y(zh-CN) | Y(zh/chi) | ... | Y(zh-CN) | Y(zh) |\r\n| Chinese(\u7e41\u4f53) | zh-CHT | Y(zh-TW) | | Y(zh-Hant) | Y(cht) | Y(zh-TW) | | | Y | Y(cnt) | | | | | Y(zh-TW) | | | Y(zh-TW) | |\r\n| Chinese(\u6587\u8a00\u6587) | wyw | | | | Y | | | | | | | | | | | | | | |\r\n| Chinese(\u7ca4\u8bed) | yue | | | Y | Y | | | | Y | Y | Y | | | | Y(zh-HK) | | | | |\r\n| Chinese(\u5185\u8499\u8bed) | mn | N[\u5916\u8499] | N[\u5916\u8499] | | | | | | | | Y[\u5185\u8499] | | | | N[\u5916\u8499] | | | | |\r\n| Chinese(\u7ef4\u543e\u5c14\u8bed) | uy | | | | | | | | | Y | | | | | | | | | |\r\n| Chinese(\u85cf\u8bed) | ti | | | | | | | | | Y | | | | | | | | | Y |\r\n| Chinese(\u767d\u82d7\u6587) | mww | | | Y | | | | | Y | Y | | | | | | | | | |\r\n| Chinese(\u5f5d\u8bed) | ii | | | | | | | | | | Y | | | | | | | | |\r\n| Chinese(\u82d7\u8bed) | hmn | | | | | | | | | | | | | | Y | | | | |\r\n| Chinese(\u58ee\u8bed) | zyb | | | | | | | | | | | | | | | | | | |\r\n\r\n## Debug Tips\r\n\r\n### Linux Runtime Environment\r\n\r\n1. To support javascript runtime environment, you should [download and install Node.js](https://nodejs.org/en/download/).\r\n2. Function baidu() doesn't work on Linux without desktop.\r\n\r\n### HttpError 4xx\r\n\r\n1. Check whether you made high frequency requests, especially httperror 429.\r\n2. Check whether this service is provided in your region.\r\n3. Detail to solve [HttpError](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status) itself.\r\n4. [Issue me](https://github.com/UlionTse/translators/issues), thanks.\r\n\r\n### NetworkError or ProxyError\r\n\r\n1. Check whether the network is connected correctly.\r\n2. Check the proxy are enabled on your computer. If it is enabled, try turning it off or otherwise. \r\n\r\n## Star History\r\n\r\n[![Star History Chart](https://api.star-history.com/svg?repos=UlionTse/translators&type=Date)](https://star-history.com/#UlionTse/translators&Date)\r\n",
"bugtrack_url": null,
"license": "GPLv3",
"summary": "Translators is a library that aims to bring free, multiple, enjoyable translations to individuals and students in Python.",
"version": "5.9.3",
"project_urls": {
"Changelog": "https://github.com/UlionTse/translators/blob/master/change_log.txt",
"Documentation": "https://github.com/UlionTse/translators/blob/master/README.md",
"Homepage": "https://github.com/uliontse/translators",
"Source": "https://github.com/UlionTse/translators"
},
"split_keywords": [
"translate",
" translate_text",
" translate_html",
" alibaba",
" apertium",
" argos",
" baidu",
" bing",
" caiyun",
" cloudtranslation",
" deepl",
" elia",
" google",
" hujiang",
" iciba",
" iflytek",
" iflyrec",
" itranslate",
" judic",
" languagewire",
" lingvanex",
" mglip",
" mirai",
" modernmt",
" mymemory",
" niutrans",
" papago",
" qqfanyi",
" qqtransmart",
" reverso",
" sogou",
" systran",
" tilde",
" translatecom",
" translateme",
" utibet",
" volcengine",
" yandex",
" yeekit",
" youdao"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "415f2188c9b09acaad9b5e862e802337acb5fa1340a2dd40708bf5935452f540",
"md5": "32e6e475585db90daa1e021cefa03572",
"sha256": "f4af256de502fa4c7f14bc28866fcd55e098a1f041e881ab8ef41bfba38f8b36"
},
"downloads": -1,
"filename": "translators-5.9.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "32e6e475585db90daa1e021cefa03572",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 56949,
"upload_time": "2024-09-28T19:15:20",
"upload_time_iso_8601": "2024-09-28T19:15:20.130780Z",
"url": "https://files.pythonhosted.org/packages/41/5f/2188c9b09acaad9b5e862e802337acb5fa1340a2dd40708bf5935452f540/translators-5.9.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "85def81a8796bd75f4780c7cf2149e7e419bbd1666fed483979942a8c47e6e4a",
"md5": "4a828e47b1ae946475449f975cb6da39",
"sha256": "e219708d419f9b2b502c8ad61b7f6fd9771cd1ff80632df069c027a69da0c72d"
},
"downloads": -1,
"filename": "translators-5.9.3.tar.gz",
"has_sig": false,
"md5_digest": "4a828e47b1ae946475449f975cb6da39",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 79266,
"upload_time": "2024-09-28T19:15:21",
"upload_time_iso_8601": "2024-09-28T19:15:21.841752Z",
"url": "https://files.pythonhosted.org/packages/85/de/f81a8796bd75f4780c7cf2149e7e419bbd1666fed483979942a8c47e6e4a/translators-5.9.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-28 19:15:21",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "uliontse",
"github_project": "translators",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "requests",
"specs": []
},
{
"name": "PyExecJS",
"specs": []
},
{
"name": "lxml",
"specs": []
},
{
"name": "tqdm",
"specs": []
},
{
"name": "pathos",
"specs": []
},
{
"name": "cryptography",
"specs": []
}
],
"lcname": "translators"
}