mirror of
https://github.com/LibreTranslate/LibreTranslate.git
synced 2024-11-16 12:30:11 +01:00
Update CONTRIBUTING.md
This commit is contained in:
parent
c45a62778d
commit
05e66d4147
@ -18,51 +18,6 @@ sudo apt-get install cmake
|
|||||||
sudo dnf install cmake
|
sudo dnf install cmake
|
||||||
```
|
```
|
||||||
|
|
||||||
## Getting Started
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git clone https://github.com/LibreTranslate/LibreTranslate.git
|
|
||||||
cd LibreTranslate
|
|
||||||
pip install -e .
|
|
||||||
libretranslate [args]
|
|
||||||
|
|
||||||
# Or
|
|
||||||
python main.py [args]
|
|
||||||
```
|
|
||||||
|
|
||||||
Then open a web browser to <http://localhost:5000>
|
|
||||||
|
|
||||||
## Run with Docker
|
|
||||||
|
|
||||||
Linux/macOS: `./run.sh [args]`
|
|
||||||
Windows: `run.bat [args]`
|
|
||||||
|
|
||||||
Then open a web browser to <http://localhost:5000>
|
|
||||||
|
|
||||||
## Build with Docker
|
|
||||||
|
|
||||||
```bash
|
|
||||||
docker build -f docker/Dockerfile [--build-arg with_models=true] -t libretranslate .
|
|
||||||
```
|
|
||||||
|
|
||||||
If you want to run the Docker image in a complete offline environment, you need to add the `--build-arg with_models=true` parameter. Then the language models are downloaded during the build process of the image. Otherwise, these models get downloaded on the first run of the image/container.
|
|
||||||
|
|
||||||
Run the built image:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
docker run -it -p 5000:5000 libretranslate [args]
|
|
||||||
```
|
|
||||||
|
|
||||||
Or build and run using Docker Compose:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
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 `/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.
|
|
||||||
|
|
||||||
## FAQ
|
## FAQ
|
||||||
|
|
||||||
### Externally Managed Environment
|
### Externally Managed Environment
|
||||||
|
Loading…
Reference in New Issue
Block a user