diff --git a/Dockerfile b/Dockerfile index a51883d..0c8034b 100644 --- a/Dockerfile +++ b/Dockerfile @@ -24,7 +24,7 @@ FROM python:3.8.14-slim-bullseye ARG with_models=false ARG models= -RUN addgroup --system --gid 1032 libretranslate && adduser --system --uid 1032 libretranslate +RUN addgroup --system --gid 1032 libretranslate && adduser --system --uid 1032 libretranslate && mkdir -p /home/libretranslate/.local && chown -R libretranslate:libretranslate /home/libretranslate/.local USER libretranslate COPY --from=builder --chown=1032:1032 /app /app diff --git a/README.md b/README.md index 884e641..f349a50 100644 --- a/README.md +++ b/README.md @@ -130,11 +130,8 @@ Then open a web browser to http://localhost:5000 ### Run with Docker -Simply run: - -```bash -docker run -ti --rm -p 5000:5000 libretranslate/libretranslate -``` +Linux/MacOS: `./run.sh [args]` +Windows: `run.bat [args]` Then open a web browser to http://localhost:5000 @@ -160,7 +157,7 @@ docker-compose up -d --build > Feel free to change the [`docker-compose.yml`](https://github.com/LibreTranslate/LibreTranslate/blob/main/docker-compose.yml) file to adapt it to your deployment needs, or use an extra `docker-compose.prod.yml` file for your deployment configuration. -> The models are stored inside the container under `/root/.local/share` and `/root/.local/cache`. Feel free to use volumes if you do not want to redownload the models when the container is destroyed. Be aware that this will prevent the models from being updated! +> The models are stored inside the container under `/home/libretranslate/.local/share` and `/home/libretranslate/.local/cache`. Feel free to use volumes if you do not want to redownload the models when the container is destroyed. To update the models, use the `--update-models` argument. ### CUDA @@ -198,6 +195,7 @@ docker-compose -f docker-compose.cuda.yml up -d --build | --suggestions | Allow user suggestions | `false` | LT_SUGGESTIONS | | --disable-files-translation | Disable files translation | `false` | LT_DISABLE_FILES_TRANSLATION | | --disable-web-ui | Disable web ui | `false` | LT_DISABLE_WEB_UI | +| --update-models | Update language models at startup | `false` | LT_UPDATE_MODELS | Note that each argument has an equivalent environment variable that can be used instead. The env. variables overwrite the default values but have lower priority than the command arguments and are particularly useful if used with Docker. The environment variable names are the upper-snake-case of the equivalent command argument's name with a `LT` prefix. diff --git a/VERSION b/VERSION index 31e5c84..d0149fe 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -1.3.3 +1.3.4 diff --git a/app/app.py b/app/app.py index 9976ac0..f4c5019 100644 --- a/app/app.py +++ b/app/app.py @@ -100,7 +100,7 @@ def get_routes_limits(default_req_limit, daily_req_limit, api_keys_db): def create_app(args): from app.init import boot - boot(args.load_only) + boot(args.load_only, args.update_models) from app.language import load_languages diff --git a/app/default_values.py b/app/default_values.py index 343f22c..263d4ad 100644 --- a/app/default_values.py +++ b/app/default_values.py @@ -156,6 +156,11 @@ _default_options_objects = [ 'default_value': False, 'value_type': 'bool' }, + { + 'name': 'UPDATE_MODELS', + 'default_value': False, + 'value_type': 'bool' + }, ] diff --git a/app/init.py b/app/init.py index 4b081ac..d0c4de4 100644 --- a/app/init.py +++ b/app/init.py @@ -5,9 +5,9 @@ from argostranslate import package, translate import app.language -def boot(load_only=None): +def boot(load_only=None, update_models=False): try: - check_and_install_models(load_only_lang_codes=load_only) + check_and_install_models(force=update_models, load_only_lang_codes=load_only) except Exception as e: print("Cannot update models (normal if you're offline): %s" % str(e)) diff --git a/app/main.py b/app/main.py index 6e24158..52aa06e 100644 --- a/app/main.py +++ b/app/main.py @@ -144,7 +144,9 @@ def get_args(): parser.add_argument( "--disable-web-ui", default=DEFARGS['DISABLE_WEB_UI'], action="store_true", help="Disable web ui" ) - + parser.add_argument( + "--update-models", default=DEFARGS['UPDATE_MODELS'], action="store_true", help="Update language models at startup" + ) return parser.parse_args() diff --git a/db/.gitignore b/db/.gitignore new file mode 100644 index 0000000..e69de29 diff --git a/run.bat b/run.bat new file mode 100644 index 0000000..d83c78b --- /dev/null +++ b/run.bat @@ -0,0 +1,41 @@ +@ECHO OFF + +SETLOCAL + +SET LT_PORT=5000 + +:loop +IF NOT "%1"=="" ( + IF "%1"=="--port" ( + SET LT_PORT=%2 + SHIFT + ) + IF "%1"=="--help" ( + echo Usage: run.bat [--port N] + echo: + echo Run LibreTranslate using docker. + echo: + GOTO :done + ) + IF "%1"=="--api-keys" ( + SET DB_VOLUME=-v lt-db:/app/db + SHIFT + ) + SHIFT + GOTO :loop +) + +WHERE /Q docker +IF %ERRORLEVEL% NEQ 0 GOTO :install_docker + +docker run -ti --rm -p %LT_PORT%:%LT_PORT% %DB_VOLUME% -v lt-local:/home/libretranslate/.local libretranslate/libretranslate %* + +GOTO :done + +:install_docker +ECHO Cannot find docker! Go to https://docs.docker.com/desktop/install/windows-install/ and install docker before running this script (pressing Enter will open the page) +pause +start "" https://docs.docker.com/desktop/install/windows-install/ +GOTO :done + +:done \ No newline at end of file diff --git a/run.sh b/run.sh new file mode 100755 index 0000000..ee43d30 --- /dev/null +++ b/run.sh @@ -0,0 +1,89 @@ +#!/bin/bash +set -eo pipefail +__dirname=$(cd "$(dirname "$0")"; pwd -P) +cd "${__dirname}" + +platform="Linux" # Assumed +uname=$(uname) +case $uname in + "Darwin") + platform="MacOS / OSX" + ;; + MINGW*) + platform="Windows" + ;; +esac + +usage(){ + echo "Usage: $0 [--port N]" + echo + echo "Run LibreTranslate using docker." + echo + exit +} + +export LT_PORT=5000 + +# Parse args for overrides +ARGS=() +while [[ $# -gt 0 ]] +do +key="$1" +case $key in + --port) + export LT_PORT="$2" + ARGS+=("$1") + ARGS+=("$2") # save it in an array for later + shift # past argument + shift # past value + ;; + --debug) + export LT_DEBUG=YES + ARGS+=("$1") + shift # past argument + ;; + --api-keys) + export DB_VOLUME="-v lt-db:/app/db" + ARGS+=("$1") + shift # past argument + ;; + --help) + usage + ;; + *) # unknown option + ARGS+=("$1") + shift # past argument + ;; +esac +done + +# $1 = command | $2 = help_text | $3 = install_command (optional) +check_command(){ + hash "$1" 2>/dev/null || not_found=true + if [[ $not_found ]]; then + check_msg_prefix="Checking for $1... " + + # Can we attempt to install it? + if [[ -n "$3" ]]; then + echo -e "$check_msg_prefix \033[93mnot found, we'll attempt to install\033[39m" + $3 || sudo $3 + + # Recurse, but don't pass the install command + check_command "$1" "$2" + else + check_msg_result="\033[91m can't find $1! Check that the program is installed and that you have added the proper path to the program to your PATH environment variable before launching WebODM. If you change your PATH environment variable, remember to close and reopen your terminal. $2\033[39m" + fi + fi + + echo -e "$check_msg_prefix $check_msg_result" + if [[ $not_found ]]; then + return 1 + fi +} + +environment_check(){ + check_command "docker" "https://www.docker.com/" +} + +environment_check +docker run -ti --rm -p $LT_PORT:$LT_PORT $DB_VOLUME -v lt-local:/home/libretranslate/.local libretranslate/libretranslate ${ARGS[@]} \ No newline at end of file