Hướng dẫn cài VieNeu-TTS

Cài đặt VieNeu-TTS trên Windows

https://www.vieneu.io/

1. Yêu cầu

• Windows 10/11
• Python 3.12
• Git
• NVIDIA Driver (nếu dùng GPU NVIDIA)

2. Cài uv

Mở PowerShell

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

kiểm tra

uv --version

3. Thiết lập thư mục cache (tùy chọn)

Nếu bạn muốn để cache ở ổ C: thì không cần làm bước này.

Tạo thư mục, ví dụ:

G:\Cache\uv
G:\Cache\huggingface

Thêm hai biến môi trường:

Đóng và mở lại PowerShell.

Kiểm tra:

echo $env:UV_CACHE_DIR
echo $env:HF_HOME

4. Clone project

cd G:\Project
git clone https://github.com/pnnbao97/VieNeu-TTS.git
cd VieNeu-TTS

5. Cài dependency

Tùy theo bạn muốn dùng GPU hay CPU

GPU NVIDIA

uv sync --group gpu

CPU

uv sync

6. Cài PyMuPDF (tùy chọn)

Cài nếu bạn muốn đọc file PDF

uv add PyMuPDF

7. Khởi động

uv run vieneu-web

Mở:

http://127.0.0.1:7860

Tải Model bạn muốn

8. Khởi động nhanh (tùy chọn)

Tạo file start.bat trong thư mục project:

@echo off

cd /d "%~dp0"
uv run vieneu-web
pause

Lần sau chỉ cần chạy file này cho dễ.

9. Cập nhật project (tùy chọn)

git pull
uv sync