ARPK

Ollama as your translator, with DeepLX-compatible API.

Usage

Prepare

You need to run Ollama and download the model you want to use.

ollama serve
ollama pull llama3.2

Install

First install Node.js, then install ARPK via your favorite package manager (or npm).

npm i -g arpk

You can also use ARPK via npx without installing it:

npx -y arpk

Translate

arpk translate --from "EN-US" --to "ZH" --input "Hello, World!"
# 你好，世界！

echo "Hello, World!" | arpk translate --from "EN-US" --to "JA"
# こんにちは、世界！

Serve

ARPK_MODEL="llama3.2" arpk serve

npx

ARPK_MODEL="llama3.2" npx -y arpk serve

docker

docker run -d \
  --name arpk \
  --network host \
  --restart unless-stopped \
  -e ARPK_MODEL=llama3.2 \
  ghcr.io/moeru-ai/arpk:latest

docker-compose

services:
  arpk:
    image: ghcr.io/moeru-ai/arpk:latest
    container_name: arpk
    network_mode: host
    restart: unless-stopped
    environment:
      - ARPK_MODEL=llama3.2

API

/translate, /api/v1/translate and /api/v2/translate are connected to the same translate endpoint.

await fetch('http://127.0.0.1:1188/translate', {
  body: JSON.stringify({
    source_lang: 'JA',
    target_lang: 'ZH',
    text: '雨の季節が過ぎ 澄み渡る空を 眺めて独り想フ'
  }),
  method: 'POST'
}).then(res => res.json())
// {
//   alternates: [],
//   code: 200,
//   data: '雨季过后，晴朗的天空下我独自遐思。',
//   id: 1519129853500,
//   method: 'ARPK v0.0.0 (llama3.2)',
//   source_lang: 'JA',
//   target_lang: 'ZH'
// }

Environments

Currently only Bearer Auth is supported when using ARPK_TOKEN, not URL Params.

| Environment | Default | Description | |---|---|---| | ARPK_PORT | 1188 | The port the server will listen on | | ARPK_MODEL | llama3.1 | Model to be used by the ARPK | | ARPK_TOKEN | null | Access token to protect your API | | ARPK_OLLAMA_HOST | http://127.0.0.1:11434 | The Ollama host address | | ARPK_SYSTEM_PROMPT | https://github.com/moeru-ai/arpk/blob/main/src/lib/prompts.ts | System prompt | | ARPK_SOURCE_LANG | null | Translate source language (cli only, --from) | | ARPK_TARGET_LANG | null | Translate target language (cli only, --to) |

License

MIT