deep-translator

What it is and what it does

deep-translator is a Python wrapper that abstracts multiple free translation services (Google Translate, Microsoft Translator, DeepL, Yandex, Linguee, Pons, MyMemory, Papago, QcriTranslator, and ChatGpt) behind a unified API. You instantiate a translator class, specify source and target languages, and call translate() to get results. It also supports automatic language detection, batch translation, file-based translation (text, DOCX, PDF), and proxy configuration.

The package is designed for developers who need simple, free multilingual translation without managing multiple APIs or dealing with authentication complexity. It depends on beautifulsoup4 and requests to scrape or query these services. Maintenance is dormant (last release June 2023, last commit July 2024), so while it is marked Production/Stable, you should expect no active support or fixes if underlying services change.

Use it for:

• Translate user-generated content or documents in a web application without paying for a dedicated translation API.
• Automate bulk translation of text files or document collections across multiple languages for localization workflows.
• Detect the language of incoming text automatically to route it to the correct processing pipeline.
• Compare translations from multiple services to choose the best result or validate translation quality.
• Integrate translation into a CLI tool or batch job that processes documents from the terminal.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Translates text between languages using multiple free translation services (Google, Microsoft, DeepL, Yandex, and others) with automatic language detection and batch processing support.

Yes, if you need free, simple translation and can tolerate dormant maintenance. The low install friction, permissive license, and broad translator coverage make it practical for one-off scripts and small projects. However, do not rely on it for production systems where translation service availability is critical—the dormant status means breakage from service changes will not be fixed promptly. One known vulnerability (PYSEC-2022-252) should be reviewed before use in sensitive contexts.

Install

deep-translator on PyPI

pip install deep-translator

uv add deep-translator

poetry add deep-translator

Installing deep-translator

Before you install

Low friction: pure Python wheel with only two runtime dependencies (beautifulsoup4, requests). Maintenance is dormant—last commit was 2024-07-23 and the latest release dates to 2023-06-28, so expect no active bug fixes or feature development, though the codebase is marked Production/Stable.

License in practice

MIT license (permissive): you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions, provided you include the license notice.

Quickstart

pip install deep-translator

from deep_translator import GoogleTranslator

translated = GoogleTranslator(source='auto', target='de').translate('hello world')

Some translators (e.g., ChatGpt, language detection) require external API keys; the base translators rely on web scraping and may break if target services change their HTML structure.

Verify before relying

• Whether web-scraping-based translators (Google, Linguee, Pons, MyMemory) remain functional given the dormant maintenance status and potential service changes.
• Current status of the PYSEC-2022-252 vulnerability and whether it affects version 1.11.4 or has been mitigated.
• Whether the package's dependency on beautifulsoup4 and requests for web scraping introduces reliability or legal concerns with the underlying translation services.

Package facts

Evidence: deep_translator-1.11.4-py3-none-any.whl

Keywords: deep_translator, deepL, DeeplTranslator, translator, translation, automation, web scraping, google translator, google translation, google trans, PONS, YANDEX, MyMemory translator, Linguee, QcriTranslator, Language, Language detection, detect language, free translation, unlimited translation, translate for free

Tags

More Software Development packages