Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/UlionTse/translators
🌏🌍🌎Translators🌎🌍🌏 is a library that aims to bring free, multiple, enjoyable translations to individuals and students in Python. Translators是一个旨在用Python为个人和学生带来免费、多样、愉快翻译的库。
https://github.com/UlionTse/translators
alibaba argos baidu bing caiyun deepl google iciba iflytek itranslate lingvanex modernmt mymemory niutrans papago reverso sogou tencent yandex youdao
Last synced: 17 days ago
JSON representation
🌏🌍🌎Translators🌎🌍🌏 is a library that aims to bring free, multiple, enjoyable translations to individuals and students in Python. Translators是一个旨在用Python为个人和学生带来免费、多样、愉快翻译的库。
- Host: GitHub
- URL: https://github.com/UlionTse/translators
- Owner: UlionTse
- License: gpl-3.0
- Created: 2017-10-09T11:21:20.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-09-28T19:27:23.000Z (about 2 months ago)
- Last Synced: 2024-10-29T15:06:37.415Z (18 days ago)
- Topics: alibaba, argos, baidu, bing, caiyun, deepl, google, iciba, iflytek, itranslate, lingvanex, modernmt, mymemory, niutrans, papago, reverso, sogou, tencent, yandex, youdao
- Language: Python
- Homepage: https://pypi.org/project/translators/
- Size: 472 KB
- Stars: 1,660
- Watchers: 22
- Forks: 192
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Changelog: change_log.txt
- License: LICENSE
Awesome Lists containing this project
- awesome-translations - Translator - A translator library based on the translation interface of Google, Yandex, Microsoft (Bing), Baidu, Alibaba, Tencent, NetEase (Youdao), Sogou, Deepl, etc. (Tools / Libraries and tools for developers)
README
* * *
**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 = '''《季姬击鸡记》
还有另一篇文章《施氏食狮史》。
'''
### 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
[](https://star-history.com/#UlionTse/translators&Date)