free-deepl-translator 1.1.2

Unofficial free DeepL translator client (No auth)

free-deepl-translator

Unofficial free DeepL translator client for Python — this package lets you translate text using DeepL without requiring an API key by or an Auth token.

⚠️ Unofficial: this project reverse-engineers DeepL's web protocol. It may break if DeepL changes their site and may violate DeepL's Terms of Service. Use at your own risk.

Installation

Install from PyPI:

pip install free-deepl-translator

Quick example

import free_deepl_translator as deepl

# Create the client
deepl_instance = deepl.Deepl()

# Create a session (returns True on success and False on failure)
d = deepl_instance.Session()

assert d is True
print("Session created")

# Simple translate to French
translated = deepl_instance.Translate("H-h-how are you ?", target_lang="fr")
if translated["status"] == 0:
    print(f"Translated text: {translated['text']}")

# Translate from French to English
translated = deepl_instance.Translate("Je vais bien, merci", target_lang="en", source_lang="fr")
if translated["status"] == 0:
    print(f"Translated text: {translated['text']}")

# Advanced call: specify model, glossary and formality
translated = deepl_instance.Translate(
    "Can you please send me the report?",
    target_lang="fr",
    source_lang="en",
    target_model="next-gen",
    glossary=[{"source": "report", "target": "vidéo"}],
    formality="informal",
)
if translated["status"] == 0:
    print(f"Translated text: {translated['text']}")

To use it with Async you can use SessionAsync() and TranslateAsync().

Return format

Translate() and TranslateAsync() return a dictionary like:

{
  "status": 0,    # 0 = success, non-zero = error
  "text": "..." # translated text when successful
  "msg": "..." # error message (when status != 0)
}

Features

• Translate text without an API key (no auth).
• Supports explicit source_lang.
• target_model selection (e.g. next-gen or classic).
• Glossary entries (list of {source, target} mappings).
• formality | tone control.