本地部署 libretranslate
Window本地部署 libretranslate
目录
Libretranslate
网址
安装
安装问题
解决方案
步骤 1
步骤 2
步骤 3
提示错误
解决步骤
步骤 1
步骤 2
步骤 3
问题
安装libretranslate提示
启动
本地访问
请求失败
总结
Libretranslate
LibreTranslate 是一款开源、免费且支持自托管的机器翻译引擎，其核心优势在于完全不依赖谷歌、百度、微软等第三方在线翻译服务，所有翻译计算均可在本地设备（如电脑、服务器、NAS甚至树莓派）上完成，确保数据隐私与安全。
网址
https://docs.libretranslate.com/guides/installation/
安装
使用Python
请确保已安装 Python >= 3.8,然后从终端运行:
pip install libretranslate libretranslate [args]安装问题
安装libretranslate时提示错误：
解决方案
步骤 1
先按提示升级 pip（必做，旧版 pip 是主要诱因）
直接在命令行执行提示里的升级命令，以管理员身份运行 CMD/PowerShell 执行更稳妥（避免权限不足）：
python.exe -m pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple步骤 2
安装 Python 包编译所需的基础构建依赖（Windows 必装）
LibreTranslate 的部分依赖包需要本地编译，Windows 默认没有 C++ 编译工具和 Python 构建组件，会直接导致「构建依赖安装失败」，先安装基础构建包：
pip install wheel setuptools build -i https://pypi.tuna.tsinghua.edu.cn/simple步骤3
用国内镜像源安装 LibreTranslate（避免网络下载中断）
完成以上环境准备后，用清华 / 阿里镜像源安装 LibreTranslate，彻底解决官方源下载慢、断连导致的依赖安装失败，执行命令：
pip install libretranslate -i https://pypi.tuna.tsinghua.edu.cn/simple提示错误
note: This error originates from a subprocess, and is likely not a problem with pip.
ERROR: Failed to build 'spacy' when installing build dependencies for spacy
若没装过基础构建包，先补装：
pip install wheel setuptools build cmake -i https://pypi.tuna.tsinghua.edu.cn/simple解决步骤
步骤 1
安装 Windows 预编译版spacy（指定稳定版，避免兼容问题）
用国内源安装spacy最新稳定版（3.7.x，与 LibreTranslate 完美兼容），pip 会自动匹配 Windows 的预编译包：
pip install spacy==3.7.5 -i https://pypi.tuna.tsinghua.edu.cn/simple步骤 2
安装spacy轻量语言模型（LibreTranslate 必需，否则启动报错）
spacy运行必须搭配语言模型，LibreTranslate 依赖其基础模型做文本处理，装轻量版即可（体积小、安装快），执行专用命令下载：
# 安装英文轻量模型（LibreTranslate核心依赖），自动适配已装的spacy版本
python -m spacy download en_core_web_sm -i https://pypi.tuna.tsinghua.edu.cn/simple步骤 3
正式安装 LibreTranslate（此时无构建报错）
spacy和基础环境都到位后，再装 LibreTranslate，pip 会直接使用已安装的依赖，不会再触发任何构建操作：
pip install libretranslate -i https://pypi.tuna.tsinghua.edu.cn/simple问题
步骤2 requests.exceptions.ConnectionError: ('Connection aborted.', TimeoutError(10060, '由于连接方在一段时间后没有正确答复或连接的主机没有反应，连接尝试失败。', None, 10060, None)) 需要更换为国外网络后，重新执行步骤2
安装libretranslate提示
ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts.
build 1.4.0 requires packaging>=24.0, but you have packaging 23.1 which is incompatible.
torchvision 0.12.0+cu113 requires torch==1.11.0, but you have torch 2.4.0 which is incompatible.
wheel 0.46.3 requires packaging>=24.0, but you have packaging 23.1 which is incompatible.
这些是pip 依赖冲突警告，并非安装失败的错误
升级 packaging 到兼容版本
python.exe -m pip install packaging==24.1 -U -i https://pypi.tuna.tsinghua.edu.cn/simple这个结果是完全正常的！你已经成功把packaging升级到了24.1 这个唯一的兼容版，屏幕上的只是 pip 的版本检查警告，不是安装失败的错误，最后一行Successfully installed packaging-24.1才是关键 —— 代表环境已经调整到位，所有依赖的兼容问题都解决了。
启动
Libretranslate运行效果：
然后打开网页浏览器以 http://localhost:5000
默认情况下,LibreTranslate 将为所有可用语言安装支持。只需加载某些语言并缩短启动时间,您就可以使用--load-only:
libretranslate --load-only en,es,fr本地访问
http://127.0.0.1:5000/?source=auto&target=ko&q=%E4%B8%AD%E6%96%87
中文翻译为韩语
请求失败
窗口提示
requests.exceptions.ConnectionError: HTTPSConnectionPool (host='huggingface.co', port=443): Max retries exceeded with url: /stanfordnlp/stanza-zh-hans/resolve/v1.10.0/models/tokenize/gsdsimp.pt (Caused by NewConnectionError('<urllib3.connection.HTTPSConnection object at 0x00000211205A1340>: Failed to establish a new connection: [WinError 10060] 由于连接方在一段时间后没有正确答复或连接的主机没有反应，连接尝试失败。'))发现不是真正的本地翻译，还需要请求远程，需要使用国外网络才能使用翻译。
总结
Window本地部署 libretranslate不太适合国内项目使用，使用Api需要购买密钥，至于托管还没有研究怎么使用。