eggplants/deepl-cli

deepl‑cli – DeepL 翻譯器的命令列包裝工具

這是什麼 – 一個輕量級的 Python 套件，讓你可以在終端機（或 Python 程式碼中）呼叫 DeepL 網頁翻譯器，無需付費的 DeepL API 金鑰。它使用 Playwright 操作 DeepL 網站，擷取翻譯結果，並回傳給你。

為什麼重要 – 翻譯是許多 AI 驅動工作流程的常見下游任務（例如，本地化文件、預處理多語言語料庫，或建立快速查詢工具）。擁有零設定的 CLI，讓你可以在 shell 或 CI 管道中撰寫翻譯腳本，無需註冊 API。

如何取得 – 從 PyPI 安裝：

pip install deepl-cli

該套件會引入 playwright，並在首次執行時自動下載所需的瀏覽器二進位檔。

常見命令列用法

# 將英文短語翻譯成日文
$ deepl -F en -T ja -s <<< 'This tool is useful for me.'
このツールは私にとって役に立ちます。

# 從檔案讀取並翻譯
$ deepl -f mytext.txt -F en -T fr

重要旗標：

• -F / --fr – 來源語言（或使用 auto 讓 DeepL 自動偵測）。
• -T / --to – 目標語言（支援許多 ISO 風格的代碼）。
• -s – 從 stdin 讀取來源文字。
• -f – 翻譯檔案內容。
• --no-headless – 顯示瀏覽器視窗（適合除錯）。
• -t – 超時時間（毫秒）。

Python API – 如果你偏好將翻譯嵌入腳本中：

from deepl import DeepLCLI

translator = DeepLCLI('en', 'ja')
print(translator.translate('hello'))   # → こんにちは

也提供非同步版本（translate_async），適用於 asyncio 程式碼（詳見 examples/async.py）。

限制 – 因為它會抓取公開的 DeepL 網站，所以會受到與一般使用者相同的速率限制和使用政策約束。若需處理大量或商業用途的工作負載，建議改用官方 DeepL API（README 中已指向 deepl-python）。

授權 – MIT，因此你可以自由修改或將其嵌入其他工具中。