Bỏ qua tới nội dung
Ông T.vn

Handy: gõ chữ bằng giọng nói, chạy offline, miễn phí — hướng dẫn cài đặt và dùng

11 phút đọcCập nhật

Bài này là một góc nhìn khác về cjpais/Handy — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: Handy: gõ chữ bằng giọng nói, chạy offline, miễn phí — hướng dẫn cài đặt và dùng →

Handy: gõ chữ bằng giọng nói, chạy offline, miễn phí — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

Handy là ứng dụng chuyển giọng nói thành văn bản chạy ngay trên máy bạn, không gửi âm thanh lên đám mây. Bạn nhấn một phím tắt, nói, rồi chữ được dán vào bất kỳ ô nhập liệu nào. Cài đặt khá dễ vì có sẵn bản cài cho Windows, macOS và Linux, không cần biết lập trình.

Handy là ứng dụng máy tính miễn phí, mã nguồn mở, giúp bạn gõ chữ bằng giọng nói và chạy hoàn toàn offline. Bạn nhấn một phím tắt, nói, rồi lời nói được chuyển thành chữ và dán thẳng vào ứng dụng đang mở: Word, trình duyệt, ô chat, email, trình soạn code… Toàn bộ xử lý diễn ra trên máy bạn, âm thanh không bị gửi lên đám mây.

Repo này hợp với người hay phải gõ nhiều: chủ shop trả lời khách, nhân viên văn phòng soạn email, người viết nội dung, lập trình viên mới muốn ghi chú nhanh. Cũng hợp với người gõ phím khó khăn, vì tác giả định hướng đây là công cụ hỗ trợ tiếp cận cho mọi người. Hiện repo có khoảng 38.600 sao và 3.637 fork, giấy phép MIT, và vẫn được cập nhật trong 3 tháng gần đây.

Điểm đáng giá nhất là sự đơn giản: một công cụ, một việc. Không tài khoản, không thuê bao, không phải hiểu AI. Bạn cài như cài phần mềm thông thường rồi dùng. Xem video ngắn bên dưới để thấy nó chạy thực tế trước khi cài.

Ứng dụng

cjpais/Handy

Handy là ứng dụng máy tính miễn phí, mã nguồn mở: nhấn phím tắt, nói, chữ hiện vào ô nhập liệu. Chạy hoàn toàn offline trên Windows, macOS, Linux.

★ 39kRustMIT
Xem repo trên GitHub
Video giới thiệu HandyXem trên YouTubeXem trên Facebook

I.Handy làm được gì

Dưới đây là những tính năng chính, kèm lợi ích bạn nhận được trong công việc hằng ngày.

  • Chuyển giọng nói thành chữ ngay trên máy. Âm thanh được xử lý cục bộ, nên bạn đọc nội dung nhạy cảm (hợp đồng, thông tin khách hàng) mà không lo bị gửi đi đâu.
  • Dán chữ vào bất kỳ ô nhập liệu nào. Bạn không cần mở một cửa sổ riêng rồi copy qua lại. Con trỏ đang ở đâu, chữ vào đó.
  • Phím tắt tuỳ chỉnh với nhiều kiểu bấm. Bạn có thể giữ phím để ghi âm rồi thả ra để dừng, hoặc bấm một lần để bật và bấm lần nữa để tắt. README cũng nói có chế độ chỉ-giữ và chế độ chỉ-bật-tắt.
  • Lọc khoảng lặng. Handy dùng VAD (nhận diện có tiếng nói hay không) với Silero, nên những đoạn im lặng không bị xử lý vô ích.
  • Chọn mô hình nhận diện. Có các mô hình Whisper (Small, Medium, Turbo, Large), tận dụng GPU nếu máy có. Ngoài ra có Parakeet V3, mô hình tối ưu cho CPU, tự nhận diện ngôn ngữ. Máy yếu không có card đồ hoạ vẫn có lựa chọn.
  • Lịch sử bản ghi. README nhắc đến mục History, nơi xem lại các đoạn đã chuyển thành chữ. Hữu ích khi chữ dán sai chỗ mà bạn muốn lấy lại.
  • Điều khiển bằng dòng lệnh. Bạn có thể bật/tắt ghi âm từ bên ngoài bằng cờ lệnh, rất tiện để gán vào phím tắt của hệ điều hành hoặc công cụ khác. README tự ghi mục này phần lớn còn ở giai đoạn thử nghiệm (beta).
  • Hook xử lý chữ trước khi dán. Người dùng nâng cao trên macOS và Linux có thể gắn một script để sửa chữ ngay trước khi dán, ví dụ thêm tiền tố hay đổi chữ theo ứng dụng đang mở.
  • Tích hợp Raycast. README liệt kê một tiện ích Raycast do người ngoài làm, để bật/tắt ghi âm, xem lịch sử, quản lý từ điển, đổi mô hình và ngôn ngữ.

II.Cần chuẩn bị gì

Tư liệu của repo nói khá ít về yêu cầu phần cứng, nên mình chỉ nêu những gì có trong README:

  • Hệ điều hành: Windows, macOS hoặc Linux.
  • Micro: Bạn cần cho Handy quyền dùng micro khi mở lần đầu.
  • Quyền trợ năng (accessibility): README cũng yêu cầu cấp quyền này để Handy dán chữ vào ứng dụng khác.
  • GPU: Không bắt buộc. README nói các mô hình Whisper tận dụng GPU khi có, còn Parakeet V3 được tối ưu cho CPU.
  • Tài khoản / API key: README không nhắc tới tài khoản hay key nào để dùng chức năng chính.
  • Linux: nên cài thêm công cụ nhập chữ phù hợp (xdotool, wtype hoặc dotool), chi tiết ở phần cài đặt.

README không ghi dung lượng ổ đĩa, dung lượng RAM tối thiểu hay phiên bản hệ điều hành cụ thể. Nếu bạn cần các thông tin đó, hãy xem trang chủ handy.computer hoặc mục Issues của repo.

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

Bạn không cần Node, Rust hay biên dịch gì cả nếu chỉ muốn dùng. Chỉ người muốn tự build từ mã nguồn mới cần đọc BUILD.md.

  1. Tải bản càiVào trang releases hoặc handy.computer, tải bản cho hệ điều hành của bạn
  2. Cài ứng dụngChạy file vừa tải (hoặc dùng Homebrew, winget, apt)
  3. Mở Handy, cấp quyềnCho phép micro và trợ năng
  4. Đặt phím tắtVào Settings chọn tổ hợp phím bạn thích
  5. Thử nóiĐặt con trỏ vào một ô chữ, nhấn phím tắt và nói

A.Tải bản cài

Cách chắc chắn nhất: vào trang releases của repo (github.com/cjpais/Handy/releases) hoặc trang chủ handy.computer, tải bản mới nhất dành cho hệ điều hành của bạn. Sau đó chạy file vừa tải như mọi phần mềm khác.

B.Cài bằng trình quản lý gói (tuỳ chọn)

Nếu quen dùng terminal, README có hai lối tắt. Lưu ý chính README ghi: gói Homebrew và winget không do nhóm Handy duy trì, nên nếu muốn chắc chắn thì hãy tải trực tiếp từ trang releases.

Trên macOS (mở ứng dụng Terminal):

Terminal
brew install --cask handy

Trên Windows (mở PowerShell hoặc Terminal):

PowerShell
winget install cjpais.Handy

C.Cài trên Debian/Ubuntu

Với file .deb đã tải, README khuyên dùng APT để các thư viện cần thiết được cài theo. Hãy mở terminal ở thư mục chứa file đã tải rồi chạy:

Terminal
sudo apt install ./Handy_*.deb

Đừng dùng dpkg -i trừ khi bạn đã có sẵn các thư viện phụ thuộc. Nếu lỡ dùng rồi và bị lỗi, README bảo chạy:

Terminal
sudo apt --fix-broken install

D.Công cụ nhập chữ trên Linux

Trên Linux, để chữ được dán ổn định, README khuyên cài thêm công cụ tuỳ theo màn hình bạn đang dùng:

Terminal
sudo apt install xdotool   # X11
sudo apt install wtype     # Wayland
sudo apt install dotool    # Cả hai (cần thuộc nhóm input)

Nếu chọn dotool, bạn phải thêm tài khoản vào nhóm input rồi đăng xuất, đăng nhập lại:

Terminal
sudo usermod -aG input $USER

Nếu không cài các công cụ trên, Handy dùng phương án dự phòng là enigo, nhưng README cảnh báo có thể kém tương thích, nhất là trên Wayland.

E.Mở Handy và cấp quyền

Mở Handy lần đầu, hệ điều hành sẽ hỏi quyền micro và quyền trợ năng. Hãy bấm đồng ý. Nếu lỡ từ chối, bạn phải vào phần cài đặt quyền riêng tư của hệ điều hành để bật lại, nếu không Handy sẽ không nghe hoặc không dán được chữ.

F.Đặt phím tắt

Vào Settings trong Handy, chọn phím tắt bạn thích. Chọn kiểu giữ-để-nói hoặc bấm-bật-bấm-tắt tuỳ thói quen.

Nếu bạn dùng macOS và chọn phím tắt có phím fn (Globe), nó chỉ hoạt động với bàn phím của Apple. Bàn phím hãng khác sẽ không kích hoạt được. Hãy chọn tổ hợp ctrl, option, shift hoặc command nếu hay đổi bàn phím.

G.Muốn tự build từ mã nguồn?

README chỉ ghi: xem BUILD.md trong repo để biết hướng dẫn chi tiết theo từng hệ điều hành. Phần này dành cho lập trình viên, người dùng bình thường không cần.

IV.Kiểm tra đã chạy được chưa

Cách thử đơn giản nhất làm theo đúng luồng README mô tả:

  1. Mở Notepad, Word, ô tìm kiếm trình duyệt hoặc bất kỳ ô nhập chữ nào, đặt con trỏ vào đó.
  2. Nhấn phím tắt bạn đã đặt, nói một câu ngắn, rồi thả phím (hoặc bấm lần nữa nếu dùng kiểu bật-tắt).
  3. Chờ một chút. Nếu chữ hiện ra trong ô nhập liệu, bạn đã cài thành công.

Nếu chữ không hiện nhưng bạn thấy nó nằm trong mục History của Handy, nghĩa là nhận diện đã chạy được, chỉ có khâu dán chữ đang vướng. Xem phần lỗi thường gặp bên dưới.

Nếu muốn thử bằng dòng lệnh, README có lệnh bật/tắt ghi âm trên một Handy đang chạy:

Terminal
handy --toggle-transcription

Lệnh handy --help sẽ liệt kê mọi cờ có sẵn.

V.Dùng vào việc thật

A.Chủ shop trả lời tin nhắn khách

Bạn bán hàng online, ngày nào cũng gõ hàng chục câu trả lời. Thay vì gõ, bạn đặt con trỏ vào ô chat, giữ phím tắt và đọc câu trả lời: “Dạ chị, mẫu này còn size M, em gửi trong hôm nay ạ”. Thả phím, chữ hiện vào ô chat để bạn đọc lại rồi gửi. Bạn nên đọc kỹ trước khi gửi vì chữ nhận diện có thể sai tên riêng hoặc từ chuyên ngành.

B.Nhân viên văn phòng soạn email và biên bản

Bạn vừa họp xong và cần ghi lại ý chính. Mở email nháp hoặc Word, bật chế độ bấm-bật-bấm-tắt, nói liền mạch vài đoạn, bấm tắt. Chữ được dán vào văn bản để bạn chỉnh sửa. Vì mọi thứ chạy trên máy, bạn không phải lo nội dung họp bị tải lên dịch vụ bên ngoài. Muốn đổi mô hình cho chính xác hơn hay nhanh hơn, bạn thử các lựa chọn Whisper hoặc Parakeet V3 trong cài đặt.

Một công cụ, một việc: nói xong là chữ nằm đúng chỗ con trỏ, không phải copy qua lại.

Ông T

C.Lập trình viên dùng trên Linux hoặc kết hợp phím tắt hệ thống

Bạn dùng Linux với Wayland, nơi phím tắt toàn cục phải do môi trường desktop quản lý. README hướng dẫn gán lệnh handy --toggle-transcription vào phím tắt tuỳ chỉnh. Với Sway hoặc i3, thêm dòng này vào file cấu hình (~/.config/sway/config hoặc ~/.config/i3/config):

ENV / INI
bindsym $mod+o exec handy --toggle-transcription

Với GNOME, vào Settings > Keyboard > Keyboard Shortcuts > Custom Shortcuts, bấm dấu +, đặt tên, điền lệnh handy --toggle-transcription và gán tổ hợp phím. KDE Plasma và Hyprland cũng có cách cấu hình tương tự trong README. Kết quả là bạn bấm phím tắt của hệ thống và Handy bắt đầu ghi âm.

D.Người dùng macOS muốn tự động sửa chữ trước khi dán

Bạn là người dùng nâng cao, muốn khi đang ở Terminal thì chữ nói ra tự có tiền tố # (để làm ghi chú). README có ví dụ hook: đặt một file chạy được tên transcription vào thư mục hooks trong thư mục dữ liệu của Handy. Handy đưa chữ vào đầu vào chuẩn của script, rồi dán kết quả script in ra. Nếu script lỗi hoặc chạy quá 30 giây, chữ gốc vẫn được dán.

Terminal
mkdir -p ~/Library/Application\ Support/com.pais.handy/hooks
cd ~/Library/Application\ Support/com.pais.handy/hooks
cat > transcription << 'EOF'
#!/bin/bash
app=$(osascript -e 'tell application "System Events" to get name of first application process whose frontmost is true')
if [ "$app" = "Terminal" ]; then echo "# $(cat)"; else cat; fi
EOF
chmod +x transcription

Các lệnh trên tạo thư mục hooks, tạo file script, rồi cấp quyền chạy cho nó. Lưu ý hook không nhận biến PATH của shell của bạn, nên nếu gọi chương trình khác phải ghi đường dẫn đầy đủ (ví dụ /opt/homebrew/bin/opencc). Trên Linux, thư mục dữ liệu là ~/.local/share/com.pais.handy/.

VI.Lỗi hay gặp và cách xử lý

A.Chữ dán ra là nội dung bạn copy trước đó

Chữ đúng trong History nhưng ô nhập lại hiện nội dung clipboard cũ. README nói đây là vấn đề đã biết (issue #502): Handy khôi phục clipboard sau một khoảng trễ cố định, máy bận thì ứng dụng đích đọc clipboard sau khi đã bị khôi phục. Cách xử lý theo README:

  1. Mở cửa sổ cài đặt Handy, nhấn Cmd+Shift+D (macOS) hoặc Ctrl+Shift+D (Windows/Linux) để hiện mục Debug.
  2. Trên macOS và Windows, thử bật Reliable Paste (Beta) (cần chọn kiểu dán bằng clipboard). Đây vẫn là tính năng thử nghiệm, bạn nên kiểm tra trong chính ứng dụng đang gặp lỗi.
  3. Nếu không dùng được, tăng Paste Delay (After) rồi thử lại.

B.Linux: chữ không dán được hoặc dán sai cửa sổ

Trên Linux, nguyên nhân thường là thiếu công cụ nhập chữ hoặc do cửa sổ overlay ghi âm cướp mất tiêu điểm. Cài xdotool (X11) hoặc wtype/dotool (Wayland). Rồi vào Settings > Advanced, đặt Overlay Position thành None. Nếu vẫn muốn có báo hiệu, bật Audio Feedback trong cùng mục.

C.Linux: mở ứng dụng bị báo thiếu thư viện

Nếu thấy lỗi error while loading shared libraries: libgtk-layer-shell.so.0, cài gói runtime tương ứng. Ubuntu/Debian:

Terminal
sudo apt install libgtk-layer-shell0

Fedora/RHEL dùng sudo dnf install gtk-layer-shell, Arch Linux dùng sudo pacman -S gtk-layer-shell.

D.Phím tắt có phím fn không phản hồi (macOS)

Đây không phải lỗi của Handy. Phím fn chỉ được macOS nhận từ bàn phím Apple. Hãy đổi sang tổ hợp dùng các phím chuẩn như ctrl, option, shift, command.

E.Dùng tai nghe Bluetooth thì tiếng nhỏ đi khi ghi âm (macOS)

Tai nghe Bluetooth chuyển sang chế độ hai chiều khi ghi âm nên chất lượng phát có thể giảm. README khuyên giữ tai nghe làm thiết bị phát, nhưng chọn micro trong của Mac hoặc micro ngoài làm thiết bị thu trong Handy.

VII.Có nên dùng không

Điểm mạnh: miễn phí, mã nguồn mở (MIT), chạy offline nên riêng tư, dùng được trên ba hệ điều hành, cài như phần mềm thường, có nhiều lựa chọn mô hình cho cả máy có và không có GPU. Cộng đồng khá lớn nên lỗi thường được ghi nhận công khai trên trang Issues.

Giới hạn: chính README thừa nhận dự án đang phát triển tích cực và còn nhiều vấn đề đã biết. Linux, nhất là Wayland, hỗ trợ còn hạn chế và cần cài thêm công cụ. Việc dán chữ qua clipboard có thể trục trặc ở một số ứng dụng. Các cờ dòng lệnh phần lớn còn là beta. Hook chỉ dành cho macOS và Linux. README đoạn mình có không nêu độ chính xác theo từng ngôn ngữ, nên bạn nên tự thử bằng tiếng Việt với giọng của mình trước khi dựa vào nó cho công việc quan trọng.

Khi nào chọn cách khác: nếu bạn cần phiên âm file ghi âm dài hoặc tách người nói trong cuộc họp, Handy không được mô tả cho việc đó, vì nó thiết kế để gõ chữ vào ô nhập liệu. Nếu bạn chấp nhận gửi âm thanh lên đám mây để đổi lấy tính năng khác, hãy so sánh thêm các dịch vụ trực tuyến. Còn nếu bạn chỉ muốn nói và có chữ trên máy mình, riêng tư và không tốn tiền, Handy là lựa chọn đáng thử trước.

4.6/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

Câu hỏi thường gặp

Handy có miễn phí không?

Có. README ghi rõ Handy là ứng dụng miễn phí và mã nguồn mở, giấy phép MIT. Mục tiêu tác giả nêu là công cụ hỗ trợ tiếp cận không nên nằm sau một bức tường trả phí.

Handy có cần internet và có gửi giọng nói của tôi lên đám mây không?

Theo README, quá trình xử lý diễn ra hoàn toàn trên máy bạn và không gửi âm thanh lên đám mây. README mô tả ứng dụng là chạy offline. Phần cách tải mô hình về lần đầu, README có nhắc mục cài mô hình thủ công cho người dùng proxy hoặc mạng hạn chế, nhưng đoạn đó bị cắt nên mình chưa có chi tiết.

Máy tôi không có card đồ hoạ (GPU) thì dùng được không?

Được. README nói các mô hình Whisper tận dụng GPU khi có, còn Parakeet V3 là mô hình tối ưu cho CPU và tự nhận diện ngôn ngữ. Tư liệu chưa nêu yêu cầu cấu hình tối thiểu cụ thể.

Handy chạy được trên Windows không?

Có. Handy chạy trên Windows, macOS và Linux. Trên Windows bạn có thể tải bản cài từ trang releases hoặc dùng lệnh winget install cjpais.Handy, nhưng gói winget không do nhóm Handy duy trì.

Handy có nhận diện được tiếng Việt không?

Tư liệu mình có không nêu danh sách ngôn ngữ được hỗ trợ hay độ chính xác theo từng ngôn ngữ. README chỉ nói Parakeet V3 tự nhận diện ngôn ngữ và Raycast có thể đổi ngôn ngữ. Bạn nên tự thử với giọng của mình, hoặc xem trang chủ handy.computer.

Tại sao Handy không dán được chữ vào ứng dụng của tôi?

Có vài nguyên nhân thường gặp: chưa cấp quyền trợ năng, dán qua clipboard bị khôi phục quá sớm, hoặc trên Linux thiếu xdotool/wtype/dotool hay bị overlay cướp tiêu điểm. README có mục xử lý từng trường hợp, như bật Reliable Paste hoặc tăng Paste Delay trong Debug, và đặt Overlay Position thành None trên Linux.

Handy khác gì các dịch vụ gõ bằng giọng nói trực tuyến?

Điểm khác chính theo README là Handy chạy cục bộ, miễn phí và mã nguồn mở, trong khi dịch vụ trực tuyến thường xử lý âm thanh trên máy chủ. Tư liệu không so sánh trực tiếp về độ chính xác hay tính năng với từng sản phẩm cụ thể nên mình chưa có thông tin đó.

Chuyển nhanh tới mục

  1. I.Handy làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Tải bản cài
    2. B.Cài bằng trình quản lý gói (tuỳ chọn)
    3. C.Cài trên Debian/Ubuntu
    4. D.Công cụ nhập chữ trên Linux
    5. E.Mở Handy và cấp quyền
    6. F.Đặt phím tắt
    7. G.Muốn tự build từ mã nguồn?
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop trả lời tin nhắn khách
    2. B.Nhân viên văn phòng soạn email và biên bản
    3. C.Lập trình viên dùng trên Linux hoặc kết hợp phím tắt hệ thống
    4. D.Người dùng macOS muốn tự động sửa chữ trước khi dán
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Chữ dán ra là nội dung bạn copy trước đó
    2. B.Linux: chữ không dán được hoặc dán sai cửa sổ
    3. C.Linux: mở ứng dụng bị báo thiếu thư viện
    4. D.Phím tắt có phím fn không phản hồi (macOS)
    5. E.Dùng tai nghe Bluetooth thì tiếng nhỏ đi khi ghi âm (macOS)
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.