VieNeu-TTS

1. VieNeu-TTS là gì?

VieNeu-TTS là công cụ chuyển văn bản thành giọng đọc tiếng Việt, do tác giả Phạm Nguyễn Ngọc Bảo phát triển. Bạn gõ hoặc dán một đoạn chữ, chọn một giọng, và nhận về file âm thanh. Điểm khác với nhiều dịch vụ đọc văn bản trên mạng là bản mã nguồn mở này chạy ngay trên máy tính của bạn, không cần card đồ họa rời.

Bản mã nguồn mở mới nhất trong kho GitHub là VieNeu-TTS v3 Turbo, phát hành theo giấy phép Apache 2.0 (dùng miễn phí). Nó có 25 giọng đọc sẵn của ba miền Bắc, Trung, Nam, âm thanh 48 kHz, đọc được câu lẫn tiếng Anh, và có thể nhân bản giọng từ một đoạn ghi âm mẫu dài 3 đến 8 giây.

Có hai thứ dễ nhầm với nhau, bạn nên phân biệt trước khi cài:

Thứ bạn cài	Là gì	Ai nên dùng
Ứng dụng VieNeu Desktop (file .exe)	App cho Windows của tác giả, tải về là chạy	Người không rành kỹ thuật
Mã nguồn trong kho GitHub	Giao diện web thử nghiệm đơn giản và bộ thư viện cho lập trình viên	Người chịu gõ vài lệnh, hoặc dùng macOS / Linux

Theo README, các tính năng Lồng tiếng (Dubbing), Bài giảng (Lecture), TikTok Reel và Sách nói (Audiobook) chỉ có trong ứng dụng chính thức, không có trong mã nguồn. Bản VieNeu-TTS v4 (nhân bản giọng giống gần như bản gốc) là bản đóng, không mở mã, chỉ cung cấp qua vieneu.io. Giá và điều khoản của app và của v4 bạn xem trực tiếp tại https://www.vieneu.io vì README không ghi.

Hợp với bạn nếu:

• Bạn làm video, bài giảng, sách nói và cần giọng đọc tiếng Việt mà không muốn thu âm.
• Bạn muốn văn bản được xử lý ngay trên máy mình.
• Bạn dùng Windows và muốn một file cài bấm là chạy.

Chưa hợp nếu:

• Bạn chỉ có điện thoại. Bộ công cụ cho Android / iOS mới nằm trong kế hoạch của dự án, chưa phát hành.
• Bạn dùng macOS và không muốn gõ lệnh. Bộ cài cho macOS chưa có, README ghi sẽ có trong bản sau.

2. Cần chuẩn bị gì?

Nếu dùng ứng dụng VieNeu Desktop (cách dễ nhất):

• Máy tính Windows 64-bit. Bộ cài hiện chỉ có bản x64 cho Windows.
• Khoảng 90 MB để tải bộ cài (bản 0.18.9 nặng 89,5 MB), cộng thêm chỗ trống cho app và các giọng đọc.
• Kết nối mạng để tải.

Nếu chạy từ mã nguồn:

• Windows 64-bit, Linux, hoặc máy Mac dùng chip Apple Silicon. Đây là ba nền tảng được khai báo trong file cấu hình của dự án.
• uv: công cụ tự tải đúng bản Python và các thư viện cần thiết, giúp bạn không phải cài Python bằng tay. Lệnh cài có ở Bước 1 của Cách 2. Trang chính thức: https://docs.astral.sh/uv/
• Git: công cụ tải mã nguồn từ GitHub về máy. Tải tại https://git-scm.com/downloads
• Kết nối mạng ở lần chạy đầu để tải mô hình giọng đọc. README không ghi tổng dung lượng của v3 Turbo, nên bạn để dư vài GB cho chắc.
• Không cần tài khoản, không cần khóa API.

Về cấu hình máy: CPU thông thường là đủ. Trên máy thử của tác giả (Intel Core i5 đời 12), một câu dài 10 giây mất khoảng 6 giây để tạo. Card đồ họa NVIDIA là tùy chọn, có thì nhanh hơn nhiều, không có vẫn dùng được.

3. Cài đặt từng bước

Cách 1: Ứng dụng VieNeu Desktop cho Windows (dễ nhất)

Bước 1: Tải bộ cài

Mở một trong hai trang sau:

• Trang tải của tác giả: https://www.vieneu.io/#/download
• Trang Releases trên GitHub: https://github.com/pnnbao97/VieNeu-TTS/releases/latest

Trên trang Releases, kéo xuống mục "Assets" và bấm vào file có tên dạng VieNeu_0.18.9_x64-setup.exe. Bản 0.18.9 phát hành ngày 30/9/2026; khi bạn đọc bài này con số có thể đã lớn hơn, cứ chọn file mới nhất.

Đúng là khi: trình duyệt tải về một file .exe khoảng 90 MB.

Bước 2: Chạy bộ cài

Bấm đúp vào file vừa tải. Windows SmartScreen có thể hiện cảnh báo màu xanh vì bộ cài chưa được ký chứng chỉ thương mại. Ghi chú phát hành của tác giả hướng dẫn: bấm More info, rồi bấm Run anyway.

Lưu ý: Chỉ bấm "Run anyway" với file tải từ hai trang chính thức ở Bước 1. Không tải bộ cài từ nguồn khác.

Làm theo các màn hình của bộ cài cho đến khi xong.

Đúng là khi: VieNeu xuất hiện trong menu Start và mở lên được.

Cách 2: Chạy từ mã nguồn (Windows, macOS, Linux)

Cách này cho bạn giao diện web thử nghiệm của bản mã nguồn mở. Bạn sẽ gõ bốn lệnh.

Bước 1: Cài uv

Windows (PowerShell):

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

macOS hoặc Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Đúng là khi: lệnh chạy xong không báo lỗi. Đóng cửa sổ dòng lệnh rồi mở lại để máy nhận lệnh uv.

Bước 2: Tải mã nguồn

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

Đúng là khi: máy hiện tiến trình tải rồi dừng, và dòng nhắc lệnh của bạn đang đứng trong thư mục VieNeu-TTS.

Bước 3: Cài các thư viện cần thiết

Với máy chỉ có CPU và máy Mac:

uv sync

Với máy có card NVIDIA và bạn muốn tạo giọng nhanh hơn:

uv sync --extra cuda

Chỉ chạy một trong hai lệnh. Nếu không biết máy mình có card NVIDIA hay không, hãy dùng lệnh đầu.

Đúng là khi: uv tải xong danh sách thư viện và trả lại dòng nhắc lệnh, không có dòng lỗi màu đỏ.

Bước 4: Mở giao diện web

uv run vieneu-web

Đúng là khi: cửa sổ dòng lệnh hiện địa chỉ http://127.0.0.1:7860. Mở địa chỉ đó trong trình duyệt. Đừng đóng cửa sổ dòng lệnh trong lúc dùng, vì đóng là giao diện tắt theo.

Cách 3: Dành cho người viết code Python

Nếu bạn muốn gọi VieNeu từ chương trình của mình, cài thư viện bằng một lệnh:

pip install vieneu

Ví dụ mã và cách cài cho card NVIDIA nằm trong README của dự án: https://github.com/pnnbao97/VieNeu-TTS

4. Dùng lần đầu

Với giao diện web (Cách 2):

1. Mở http://127.0.0.1:7860 trong trình duyệt.
2. Ở phần chọn mô hình, để VieNeu-TTS-v3-Turbo.
3. Chọn một giọng. Giọng mặc định là Hải Đăng. Nhóm tác giả gợi ý bắt đầu với mười giọng: Adam bựa, Trúc Ly, Thiện Minh, Mai Anh, Hải Đăng, Thùy Dung, Thiền Tâm Đức, Ngọc Huyền, Quang Sơn, Ngọc Trân.
4. Dán một câu ngắn, ví dụ "Xin chào, đây là giọng đọc chạy trên máy của mình."
5. Bấm nút tạo giọng và chờ.

Lần tạo đầu tiên lâu hơn hẳn vì máy phải tải mô hình về rồi nạp vào bộ nhớ (trên máy thử của tác giả, riêng việc nạp mất khoảng 19 giây). Các lần sau nhanh hơn.

Kết quả là một đoạn âm thanh nghe thử được ngay trên trang.

Thử thêm hai thứ:

• Thẻ cảm xúc (đang thử nghiệm): chèn thẳng [cười], [thở dài] hoặc [hắng giọng] vào giữa câu, ví dụ "Nghe hay quá đi [cười]."
• Nhân bản giọng: đưa vào một đoạn ghi âm mẫu dài 3 đến 8 giây. Công cụ tự lọc tiếng ồn nền và tự cắt đoạn mẫu về tối đa 8 giây.

Lưu ý: Chỉ nhân bản giọng của chính bạn hoặc của người đã đồng ý. Chính tác giả giữ bản v4 ở dạng đóng vì lo công nghệ này bị lạm dụng.

Với ứng dụng VieNeu Desktop: mở app từ menu Start, dán văn bản, chọn giọng và bấm tạo. Bố cục cụ thể thay đổi theo từng bản, bạn làm theo hướng dẫn hiện trong app.

5. Lỗi thường gặp và cách sửa

Dấu hiệu	Nguyên nhân	Cách sửa
Windows hiện "Windows protected your PC" khi chạy bộ cài	Bộ cài chưa được ký chứng chỉ thương mại	Bấm More info, rồi Run anyway (chỉ với file tải từ trang chính thức)
Gõ uv báo "not recognized" hoặc "command not found"	Cửa sổ dòng lệnh chưa nhận lệnh mới cài	Đóng cửa sổ, mở lại, rồi chạy tiếp từ bước đang dở
Gõ git báo "not recognized" hoặc "command not found"	Máy chưa có Git	Cài Git từ https://git-scm.com/downloads rồi mở lại cửa sổ dòng lệnh
Lần tạo giọng đầu tiên đứng rất lâu	Máy đang tải mô hình về	Chờ cho tải xong và giữ kết nối mạng. Các lần sau không phải tải lại
Trình duyệt không mở được http://127.0.0.1:7860	Giao diện chưa khởi động xong, hoặc cửa sổ dòng lệnh đã bị đóng	Chạy lại uv run vieneu-web, chờ đến khi địa chỉ hiện ra rồi mới mở trình duyệt
Âm thanh bị rè, méo sau khi bật chế độ int8	Chế độ này cần CPU có tập lệnh VNNI; CPU đời cũ không có	Quay về chế độ mặc định fp32
Máy yếu, tạo giọng quá chậm	v3 Turbo nặng so với máy	Người viết code có thể thử bản v3 Nano: nhanh hơn khoảng 3 lần nhưng chất lượng thấp hơn, âm thanh 24 kHz, 11 giọng
Đổi tham số style mà giọng không đổi	Trên v3 Turbo, style đã bị bỏ	Đổi phong cách bằng cách chọn giọng khác hoặc đổi đoạn ghi âm mẫu

Nếu lỗi của bạn không có trong bảng, tìm hoặc hỏi ở mục Issues của dự án: https://github.com/pnnbao97/VieNeu-TTS/issues

6. Gỡ cài đặt / cập nhật

Ứng dụng VieNeu Desktop:

• Cập nhật: app đang chạy sẽ tự báo khi có bản mới. Bạn cũng có thể tải bộ cài mới ở trang Releases rồi cài đè lên bản cũ.
• Gỡ: vào Settings của Windows, mục Apps, Installed apps, tìm VieNeu và chọn Uninstall.

Bản chạy từ mã nguồn:

Cập nhật, chạy trong thư mục VieNeu-TTS:

git pull
uv sync

Gỡ: đóng cửa sổ dòng lệnh đang chạy giao diện rồi xóa cả thư mục VieNeu-TTS. Các mô hình đã tải nằm trong thư mục lưu tạm của Hugging Face (mặc định là thư mục .cache/huggingface trong thư mục người dùng của bạn); xóa thư mục đó nếu muốn lấy lại dung lượng.

Thư viện Python:

pip install -U vieneu

pip uninstall vieneu

7. Câu hỏi hay gặp

Có mất tiền không? Bản mã nguồn mở v3 Turbo trong kho GitHub theo giấy phép Apache 2.0, README ghi "Free to use". Bản v4 và các tính năng riêng của ứng dụng là sản phẩm của tác giả, giá và điều khoản xem tại https://www.vieneu.io.

Có cần mạng không? Cần ở lúc cài và ở lần chạy đầu để tải mô hình. Bản mã nguồn mở được thiết kế để tạo giọng ngay trên máy.

Văn bản và giọng của tôi có bị gửi đi đâu không? Với bản mã nguồn mở v3 Turbo, việc tạo giọng diễn ra trên máy bạn. Bản v4 thì khác: nó được cung cấp qua vieneu.io và VieNeu API, tức là chạy trên máy chủ của tác giả. Hãy đọc điều khoản trên trang đó trước khi dùng.

Máy không có card đồ họa rời có chạy được không? Được. Trên CPU Core i5 đời 12, tốc độ tạo giọng nhanh gấp khoảng hai lần thời lượng âm thanh. Máy yếu hơn sẽ chậm hơn.

Dùng trên điện thoại được không? Chưa. Bộ công cụ cho Android và iOS nằm trong lộ trình nhưng chưa được đánh dấu hoàn thành.