deep-translator

You can use proxies with any supported translator by passing a proxies dictionary to the translator class. The dictionary should map protocols (e.g., http, https) to the proxy address.

from deep_translator import GoogleTranslator

# define your proxy configs:
proxies_example = {
    "https": "your https proxy",  # example: 34.195.196.27:8080
    "http": "your http proxy if available"
}

translated = GoogleTranslator(source='auto', target='de', proxies=proxies_example).translate("this package is awesome")

The preferred method to install the stable release of deep_translator is using pip. This ensures you receive the most recent stable version.

$ pip install deep_translator

To translate files in .docx or .pdf formats, you must install the corresponding extras:

• For DOCX: pip install deep-translator[docx]
• For PDF: pip install deep-translator[pdf]

Once installed, use the translate_file(path) method available on supported translators.

pip install deep-translator[docx]
pip install deep-translator[pdf]

# Example usage
path = "example/test.pdf"
translated = GoogleTranslator(source='auto', target='german').translate_file(path)

For non-Python applications, deep-translator offers an API server that allows you to leverage its translation features via direct communication. You can access the Swagger UI documentation to explore the available endpoints and integrate the service into your own applications.

https://deep-translator-api.azurewebsites.net/docs

You can install deep_translator from source by either cloning the GitHub repository or downloading the source tarball.

If you clone the repository, use poetry to manage the installation. If you download the tarball, install it directly via pip.

# Option 1: Clone the repository
$ git clone git://github.com/nidhaloff/deep_translator
$ poetry shell
$ poetry install

# Option 2: Download and install the tarball
$ curl -OJL https://github.com/nidhaloff/deep_translator/tarball/master
$ pip install /path/to/tarball/tarball_name.tar.gz

You can install the stable release of deep-translator using pip or poetry.

To include support for specific file formats or AI services, use the optional extras:

• docx: Support for .docx file translation.
• pdf: Support for .pdf file translation.
• ai: Support for ChatGPT translations.

$ pip install -U deep-translator

$ poetry add deep-translator

# With extras
$ pip install deep-translator[docx]
$ pip install deep-translator[pdf]
$ pip install deep-translator[ai]

# Poetry with extras
$ poetry add deep-translator --extras "docx pdf ai"

To perform a simple translation, import the desired translator class (e.g., GoogleTranslator), specify the source language (use 'auto' for automatic detection) and the target language, then call the .translate() method.

from deep_translator import GoogleTranslator

# Use any translator you like, in this example GoogleTranslator
translated = GoogleTranslator(source='auto', target='de').translate("keep it up, you are awesome")  # output -> Weiter so, du bist großartig

The deep-translator package provides a command-line interface (CLI) accessible via the dt command. You can use it to translate text between languages or to list the languages supported by a specific translation engine.

To see all available options, run:

dt --help

If you need to route your translation requests through a proxy, pass a dictionary containing the http and https proxy configurations to the translator constructor via the proxies argument.

from deep_translator import GoogleTranslator

proxies_example = {
    "https": "34.195.196.27:8080",
    "http": "34.195.196.27:8080"
}
translated = GoogleTranslator(source='auto', target='de', proxies=proxies_example).translate("keep it up, you are awesome")  # output -> Weiter so, du bist großartig