Skip to main content

DeepL Free

PyPI version GitHub stars License: MIT Python 3.8+

Translate text and documents with DeepL — no login, no API key required.

Features

  • No authentication or API keys needed
  • Automatic source language detection
  • 39 languages supported
  • Document translation (PDF, DOCX, PPTX)
  • Lightweight: only depends on requests

Installation

pip install deepl-free

Usage

from deepl_free import DeepL

d = DeepL()

d.translate("Hello world", target="es")
# Hola mundo

d.translate("مرحبا بالعالم", target="en")
# Hello world (source auto-detected)

d.translate("Good morning", target="ar", source="en")
# صباح الخير

d.detect("Bonjour le monde")
# FR

data = d.translate_file("report.pdf", target="ar")
open("report_ar.pdf", "wb").write(data)

translate(text, target="en", source="auto")

Argument Description Default
text Text to translate —
target Target language code or name (e.g. es) "en"
source Source language code or name, or "auto" "auto"

translate_file(path, target="en", source="auto")

Translates a document (PDF, DOCX, PPTX) and returns the translated file as bytes.

Argument Description Default
path Path to the document —
target Target language code or name "en"
source Source language code or name, or "auto" "auto"

detect(text)

Returns the detected source language code (e.g. FR).

languages()

Returns a dict mapping language codes to language names.

How it works

The library replicates DeepL's public web flows — language tables are extracted at runtime and document uploads use the same endpoints as the web translator — nothing for you to configure.

License

MIT

Metadata

Release files for deepl-free 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for deepl-free 1.0.0
File Size Uploaded
deepl_free-1.0.0.tar.gz 5.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for deepl-free 1.0.0
File Interpreter ABI Platform
deepl_free-1.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 12.1 kB

Release files / deepl_free-1.0.0.tar.gz

Download URL deepl_free-1.0.0.tar.gz
Size 5.8 kB
Tags Source
SHA-256 checksum
How to use checksums
ba70955639b2a9a19f22be4340f051b1aa6958ac4e977d320cd0810b0a386037
BLAKE2b-256 checksum
How to use checksums
37aaa5140f0eda033b7331d1848aadcb3543556bc9640c97170600cba7ff77e8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / deepl_free-1.0.0-py3-none-any.whl

Download URL deepl_free-1.0.0-py3-none-any.whl
Size 6.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6d091c965c140d1083ac802833526d9f749825d2ffd02f11f66bf3121dc70098
BLAKE2b-256 checksum
How to use checksums
5f1ba60cf6d90d187305b731631eba27f8e067977ab41049b6ae8243742739ab
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page