Cài Ollama cho TransFlow — từng bước một

Trước khi bắt đầu

• Máy tính: Mac chạy macOS 14 Sonoma trở lên, Windows 10 (bản 22H2) hoặc Windows 11, hoặc Linux.
• Bộ nhớ: 8 GB RAM là đủ cho các model nhỏ; 16 GB trở lên thì dùng được cả model lớn.
• Ổ đĩa: còn trống khoảng 5 GB (Ollama và một model).
• TransFlow đã được cài trên Chrome.

Bước 1 — Cài Ollama

Mac

1. Vào ollama.com/download/mac và bấm Download for macOS.
2. Mở file vừa tải và kéo Ollama vào thư mục Applications.
3. Mở Ollama trong Applications (hoặc Launchpad). Nếu máy hỏi bạn có chắc muốn mở không, bấm Open.
4. Biểu tượng chú lạc đà 🦙 nhỏ sẽ hiện trên thanh menu ở mép trên màn hình. Nếu có cửa sổ chat hiện ra, cứ đóng lại — Ollama vẫn chạy.

Windows

1. Vào ollama.com/download/windows và bấm Download for Windows.
2. Mở file OllamaSetup.exe vừa tải và bấm Install. Không cần quyền quản trị (administrator).
3. Ollama tự chạy. Biểu tượng lạc đà 🦙 hiện cạnh đồng hồ ở góc dưới bên phải (bấm ^ nếu không thấy). Nếu có cửa sổ chat hiện ra, cứ đóng lại.

Linux

1. Mở cửa sổ terminal (Ctrl + Alt + T trên Ubuntu và đa số hệ khác).
2. Dán lệnh cài chính thức này rồi nhấn Enter. Nếu được hỏi, gõ mật khẩu máy:

curl -fsSL https://ollama.com/install.sh | sh

Từ giờ Ollama chạy ngầm và tự bật cùng máy.

Bước 2 — Cho phép TransFlow dùng Ollama

Mặc định Ollama chỉ trả lời những ứng dụng nó tin cậy, và tiện ích trình duyệt không nằm trong danh sách đó. Bạn thêm chúng vào một lần bằng một lệnh. Ngoài ra không thay đổi gì khác trên máy, và cài đặt vẫn giữ sau khi khởi động lại.

Mac

1. Mở ứng dụng Terminal: nhấn ⌘ Cmd + Space, gõ Terminal rồi nhấn Enter.
2. Bấm Sao chép ở ô bên dưới, bấm chuột vào cửa sổ Terminal, nhấn ⌘ Cmd + V rồi Enter. Không có thông báo gì hiện ra — vậy là đúng.

mkdir -p ~/Library/LaunchAgents && cat > ~/Library/LaunchAgents/setenv.OLLAMA_ORIGINS.plist <<'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key><string>setenv.OLLAMA_ORIGINS</string>
  <key>ProgramArguments</key>
  <array><string>/bin/launchctl</string><string>setenv</string><string>OLLAMA_ORIGINS</string><string>chrome-extension://*</string></array>
  <key>RunAtLoad</key><true/>
</dict>
</plist>
EOF
launchctl unload ~/Library/LaunchAgents/setenv.OLLAMA_ORIGINS.plist 2>/dev/null; launchctl load ~/Library/LaunchAgents/setenv.OLLAMA_ORIGINS.plist

3. Khởi động lại Ollama: bấm biểu tượng lạc đà 🦙 trên thanh menu → Quit Ollama. Sau đó mở lại Ollama trong Applications.
4. Quay lại TransFlow, bấm Kiểm tra kết nối. Lần này sẽ hiện ✓.

Windows

1. Mở PowerShell: nhấn phím ⊞ Windows, gõ PowerShell rồi nhấn Enter. Không cần chạy bằng quyền quản trị.
2. Bấm Sao chép ở ô bên dưới, bấm chuột vào cửa sổ PowerShell, nhấn Ctrl + V (hoặc bấm chuột phải) rồi Enter. Không có thông báo gì hiện ra — vậy là đúng.

[System.Environment]::SetEnvironmentVariable('OLLAMA_ORIGINS','chrome-extension://*','User')

3. Khởi động lại Ollama: bấm chuột phải vào biểu tượng lạc đà 🦙 cạnh đồng hồ → Quit Ollama. Sau đó mở lại Ollama từ menu Start.
4. Quay lại TransFlow, bấm Kiểm tra kết nối. Lần này sẽ hiện ✓.

Linux

1. Trong terminal, dán lệnh này bằng Ctrl + Shift + V rồi nhấn Enter. Nếu được hỏi, gõ mật khẩu máy — chữ sẽ không hiện ra khi gõ, cứ gõ xong rồi nhấn Enter.

sudo mkdir -p /etc/systemd/system/ollama.service.d && printf '[Service]\nEnvironment="OLLAMA_ORIGINS=chrome-extension://*"\n' | sudo tee /etc/systemd/system/ollama.service.d/transflow.conf >/dev/null && sudo systemctl daemon-reload && sudo systemctl restart ollama

2. Lệnh sẽ tự khởi động lại Ollama. Quay lại TransFlow, bấm Kiểm tra kết nối. Lần này sẽ hiện ✓.

Lệnh Linux dành cho bản cài chuẩn ở bước 1, vốn chạy Ollama như một dịch vụ nền.

Bước 3 — Tải model dịch

1. Trong Cài đặt → Ollama trên máy, bước 3, bấm chọn một model. Chưa biết chọn gì? Lấy cái có nhãn Khuyên dùng.
2. Bấm Tải về và chờ thanh tiến trình chạy hết. Model 3 GB mất khoảng 5–15 phút với mạng gia đình thông thường. Trong lúc chờ bạn vẫn dùng máy bình thường.

Mẹo: máy 8 GB RAM thì chọn model dưới 3,5 GB; máy 16 GB trở lên thì model nào cũng được. Phần B trên cùng trang chỉ để dịch chữ trong ảnh — không cần thì bỏ qua.

Bước 4 — Bật lên và dịch thử

1. Ở bước 4, bật Dùng Ollama để dịch.
2. Bấm Dịch thử một câu mẫu. Lần chạy đầu tiên có thể mất tới khoảng 30 giây vì model đang được nạp vào bộ nhớ; các lần sau nhanh hơn nhiều.
3. Tuỳ chọn: muốn mọi thứ dùng Ollama trước, mở tab Dịch thuật và chọn Riêng tư / offline.

Khi có gì đó không chạy

“Không tìm thấy Ollama”

Ollama chưa được mở. Mở nó trong Applications (Mac) hoặc menu Start (Windows), tìm biểu tượng lạc đà 🦙, rồi bấm Kiểm tra kết nối lại. Nếu bạn đã sửa ô địa chỉ Ollama, hãy đặt lại thành http://127.0.0.1:11434.

Vẫn báo “chặn TransFlow” dù đã mở khoá

• Phải thoát hẳn Ollama rồi mở lại — chỉ đóng cửa sổ là chưa đủ. Dùng Quit Ollama từ biểu tượng lạc đà rồi mở lại.
• Trên Windows, hãy chắc là bạn dán vào PowerShell, không phải Command Prompt.
• Dán lệnh bằng nút Sao chép thay vì tự bôi đen, để không bị thiếu ký tự nào.
• Vẫn chưa được? Khởi động lại máy một lần — cách này luôn nạp lại cài đặt.

Tải model bị lỗi hoặc dừng giữa chừng

Kiểm tra kết nối mạng và dung lượng ổ đĩa, rồi bấm Tải về lần nữa — nó sẽ tải tiếp từ chỗ đã dừng.

Dịch chậm, hoặc máy bị chậm

Lần dịch đầu tiên sau một lúc nghỉ sẽ chậm vì model đang được nạp. Nếu lúc nào cũng chậm, hãy chọn model nhỏ hơn. Model đang nạp sẽ chiếm RAM; Ollama tự giải phóng sau 30 phút không dùng, hoặc bấm Giải phóng ở mục RAM đang giữ trong cùng trang cài đặt.

Văn phong không có tác dụng

Model chỉ-dịch (TranslateGemma, Hy-MT2) bỏ qua Văn phong. Chọn một model Qwen nếu bạn muốn dùng Văn phong và tính năng Giải thích ngay trên máy.

Huỷ mở khoá hoặc gỡ Ollama

Việc mở khoá cho phép các tiện ích trình duyệt cài trên máy này nói chuyện với Ollama. Trang web và máy tính khác vẫn không gọi được nó. Muốn huỷ, chạy lệnh cho máy của bạn rồi khởi động lại Ollama:

Mac (Terminal)

launchctl unload ~/Library/LaunchAgents/setenv.OLLAMA_ORIGINS.plist; rm -f ~/Library/LaunchAgents/setenv.OLLAMA_ORIGINS.plist; launchctl unsetenv OLLAMA_ORIGINS

Windows (PowerShell)

[System.Environment]::SetEnvironmentVariable('OLLAMA_ORIGINS',$null,'User')

Linux

sudo rm -f /etc/systemd/system/ollama.service.d/transflow.conf && sudo systemctl daemon-reload && sudo systemctl restart ollama

Gỡ hẳn Ollama: trên Mac, thoát Ollama rồi kéo nó từ Applications vào Thùng rác; trên Windows, gỡ trong Settings → Apps. Model đã tải nằm trong thư mục .ollama ở thư mục người dùng — xoá đi để lấy lại dung lượng.