---
id: deepl
version: "1.32.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# deepl — Python library for the DeepL API.

License: permissive · Maintenance: active · Downloads: 1.3M/mo

## What it is and what it does

DeepL is a Python wrapper around the DeepL API, a neural machine translation service. It lets you send text or documents to DeepL's servers and receive high-quality translations back. The library handles authentication, HTTP communication via requests, and wraps the API responses into convenient Python objects.

You use it by instantiating a DeepLClient with your API key, then calling methods like translate_text() with your source text and target language code. The library supports optional features including automatic source-language detection, formality levels (formal vs. informal), custom glossaries, context hints, and a choice of translation models (quality-optimized or latency-optimized). It returns TextResult objects containing the translated text, detected source language, and billing information.

Use it for:

- Build a multilingual web application that translates user-generated content on demand without running your own translation infrastructure.
- Automate translation of customer support tickets or documentation into multiple languages for international teams.
- Create a glossary-aware translation tool that maintains consistent terminology for domain-specific terms across translations.
- Batch-process large volumes of text or documents by leveraging the library's support for multiple inputs and formality/model options.
- Integrate real-time translation into a chat or messaging application with language auto-detection.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a Python client to interact with the DeepL API for translating text and documents with support for language detection, formality control, glossaries, and multiple translation models.

Yes. The library is actively maintained (released 1 day ago), has no known vulnerabilities, low install friction, and a permissive MIT license. It is well-suited for any Python application that needs to integrate DeepL's translation service. The main constraint is that you must obtain and manage a DeepL API key, and translation volume is subject to your account tier's character limits.

## Install

pip install deepl
uv add deepl
poetry add deepl

## Installing deepl

Before you install: Low friction: pure Python wheel with a single runtime dependency (requests 2.32.4+). Active maintenance with a release 1 day ago and 1330 repository stars. Tested on Python 3.9 through 3.13.

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

Quickstart:

pip install deepl

import deepl

auth_key = "your-api-key-here"
client = deepl.DeepLClient(auth_key)
result = client.translate_text("Hello, world!", target_lang="FR")
print(result.text)  # "Bonjour, le monde !"

Requires a DeepL API authentication key (free tier allows 500,000 characters/month); requires Python 3.9 or later.

Verify before relying:

- Whether the library fully supports all current DeepL API features or if some newer API additions lag behind the service.
- Performance characteristics and rate-limiting behavior when handling large batches or high-frequency requests.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.3M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

python translation api client, deepl api wrapper, multilingual text translation, language translation library, neural machine translation python, document translation api, auto language detection, translation, api-client, nlp

[View on SkillFed](https://skillfed.io/packages/deepl) · [View on PyPI](https://pypi.org/project/deepl/)