DeepL X

Permanently free DeepL API written in Golang

Description

deeplx in only run in port 1188, later versions will do the specified port.
deeplx is listening to 0.0.0.0:1188 by default.
deeplx is using DeepL Free API.
deeplx is unlimited to the number of requests.

Usage

Request Parameters

text: string
source_lang: string
target_lang: string

Response

{
  "alternatives": [
    "Undisputed",
    "Unquestionable",
    "Unquestionably"
  ],
  "code": 200,
  "data": "Undoubtedly",
  "id": 8300079001
}

Run with Docker

# ghcr.io
docker run -itd -p 1188:1188 ghcr.io/owo-network/deeplx:latest

# dockerhub
docker run -itd -p 1188:1188 missuo/deeplx:latest

Run with Docker Compose

mkdir deeplx
cd deeplx
wget https://raw.githubusercontent.com/OwO-Network/DeepLX/main/docker-compose.yaml
# docker compose v1
docker-compose up -d
# or docker compose v2
docker compose up -d

Run on Linux Server

bash <(curl -Ls https://cpp.li/deeplx)

Run on Mac

Homebrew (Recommended)

brew tap owo-network/brew
brew install deeplx
brew services start owo-network/brew/deeplx

# Update to the latest version
brew update
brew upgrade deeplx
brew services restart owo-network/brew/deeplx

# View the currently installed version
brew list --versions deeplx

Manual

Download the latest release of DeepL X.

sudo mv deeplx_darwin_amd64 /usr/local/bin/deeplx
sudo chmod +x /usr/local/bin/deeplx

Download the me.missuo.deeplx.plist to ~/Library/LaunchAgents.

wget https://raw.githubusercontent.com/OwO-Network/DeepLX/main/me.missuo.deeplx.plist -O ~/Library/LaunchAgents/me.missuo.deeplx.plist

Run following command.

launchctl load ~/Library/LaunchAgents/me.missuo.deeplx.plist
launchctl start ~/Library/LaunchAgents/me.missuo.deeplx.plist

Install from AUR

paru -S deeplx-bin

After installation, start the daemon with the following command.

systemctl daemon-reload
systemctl enable deeplx

Setup on Bob App

Install bob-plugin-deeplx on Bob.
Setup the API. (If you use Brew to install locally you can skip this step)

Setup on immersive-translate

It is not recommended, because the immersive-translate will send many requests in a short time, which will cause the DeepL API to block your IP.

Install Latest immersive-translate on your browser.
Click on Developer Settings in the bottom left corner. Enable Beta experimental features.
Set the URL. (If you are not deploying locally, you need to change 127.0.0.1 to the IP of your server)

Use in Python

import httpx, json

deeplx_api = "http://127.0.0.1:1188/translate"

data = {
	"text": "Hello World",
	"source_lang": "EN",
	"target_lang": "ZH"
}

post_data = json.dumps(data)
r = httpx.post(url = deeplx_api, data = post_data).text
print(r)

Backup the Docker Image of zu1k

docker run -itd -p 1188:80 missuo/deeplx-bk

This docker image is not related to this project, as the original author deleted the image, it is only for backup.

wkeylin / DeepLX