pyvideotrans

环境要求

• Windows 10/11 可直接使用预打包 exe 版，无需 Python 环境
• 源码部署需安装 uv 包管理工具，并克隆 GitHub 仓库
• 源码部署支持 macOS / Linux / Windows 开发者
• 若需 GPU 加速，需 NVIDIA 显卡并安装 CUDA 12.8 与 cuDNN 9.11
• 使用 WebUI 容器方式需本机已安装 Docker

安装与启动步骤

1. 1下载 Windows 预打包版

   Windows 10/11 用户可直接下载官方预打包版，无需配置 Python 环境，适合新手快速体验。

2. 2解压到纯英文路径

   解压到不含中文和空格的路径，例如 D:\pyVideoTrans，不要直接在压缩包内运行。

3. 3双击运行程序

   进入解压后的目录，双击 sp.exe 启动图形界面；使用 GPU 加速前需确认已装 CUDA 12.8 与 cuDNN 9.11。

4. 4安装 uv

   源码部署推荐使用 uv 做依赖管理与环境隔离，请按官方文档先安装 uv；未安装时后续 uv 命令无法执行。

5. 5克隆仓库

   从 GitHub 拉取 pyvideotrans 源码到本地，默认克隆到当前目录下的 pyvideotrans 文件夹。

   git clone https://github.com/jianchang512/pyvideotrans.git

   复制

6. 6同步项目依赖

   进入项目目录后用 uv sync 安装依赖；默认不会在本地安装 whisper.net 和 WebUI 这两个可选组件。

   cd pyvideotrans
   uv sync

   复制

7. 7按需安装可选组件

   需要 whisper.net 用 --extra dotnet，需要 WebUI 用 --extra webui，全部可选通道用 --all-extras。

   uv sync --extra dotnet
   uv sync --extra webui
   uv sync --all-extras

   复制

8. 8Docker 启动 WebUI

   README 给出的容器启动命令，映射 7860 端口并以后台方式运行名为 pyvideotrans 的容器。

   docker run -d -p 7860:7860 --name pyvideotrans pyvideotrans-webui

   复制

关键配置

如何确认成功

Docker 方式访问 http://127.0.0.1:7860 能看到 WebUI 界面；Windows 版双击 sp.exe 后正常出现主界面。

常见问题

注意事项

• README 中 Docker 部分只给出了运行命令，构建镜像的完整步骤未包含在节选内容里，实际部署前请以官方文档为准。
• 源码部署推荐使用 uv 而非 pip，以获得更快的安装速度和更好的环境隔离。
• 克隆与解压路径尽量避免中文和空格，可减少运行时报错。
• WebUI 容器默认通过 7860 端口访问，请确认该端口未被占用。