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

huggingface/transformers: chạy mô hình AI có sẵn chỉ vài dòng Python — 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ề huggingface/transformers — 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: huggingface/transformers: chạy mô hình AI văn bản, ảnh, âm thanh — hướng dẫn cài đặt và dùng →

huggingface/transformers: chạy mô hình AI có sẵn chỉ vài dòng Python — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

huggingface/transformers là thư viện Python mã nguồn mở, định nghĩa và chạy các mô hình AI hiện đại cho văn bản, hình ảnh, âm thanh và đa phương thức, cả để dùng lại lẫn huấn luyện. Bạn chỉ cần Python 3.11 trở lên và PyTorch 2.6 trở lên, rồi cài bằng một lệnh pip. Với người đã biết chạy Python cơ bản thì cài không khó, phần nặng nhất là tải mô hình lớn về máy.

Transformers là thư viện Python của Hugging Face, dùng để tải và chạy các mô hình AI hiện đại cho văn bản, hình ảnh, âm thanh, video và đa phương thức. Nó phục vụ cả hai việc: dùng mô hình có sẵn để ra kết quả (suy luận) và huấn luyện lại mô hình. Mô tả của tác giả gọi nó là "model-definition framework", tức là nơi định nghĩa mô hình một cách thống nhất.

Vấn đề nó giải quyết rất thực tế. Mỗi mô hình AI mới ra đời thường có cách dùng riêng, code riêng, khó thử. Transformers gom về một cách gọi chung. Bạn đổi tên mô hình, giữ nguyên phần còn lại, và có thể thử nhiều mô hình khác nhau. Theo README, hiện có hơn một triệu checkpoint (bản mô hình đã huấn luyện) trên Hugging Face Hub dùng được với thư viện này.

Ai nên dùng? Lập trình viên mới muốn thử AI mà không phải tự dựng mô hình, người làm văn phòng hoặc kinh doanh có chút nền Python muốn tự động hoá việc như chép lời ghi âm hay phân loại ảnh, và sinh viên, nhà nghiên cứu cần một chỗ chuẩn để thử mô hình. Repo hiện có khoảng 168.900 sao và khoảng 35.200 fork, giấy phép Apache-2.0, và vẫn được cập nhật trong 3 tháng gần đây. Điểm đáng giá nhất là công cụ pipeline: vài dòng code là chạy được một tác vụ AI.

Thư viện

huggingface/transformers

Thư viện Python của Hugging Face giúp tải và chạy mô hình AI về văn bản, ảnh, âm thanh, đa phương thức chỉ bằng vài dòng code.

★ 169kPythonApache-2.0
Xem repo trên GitHub

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

A.Một cách gọi chung cho nhiều loại dữ liệu

Công cụ cấp cao nhất là Pipeline. Theo README, đây là lớp suy luận bậc cao hỗ trợ văn bản, âm thanh, hình ảnh và đa phương thức. Nó tự xử lý bước tiền xử lý đầu vào và trả kết quả đúng dạng. Bạn không cần hiểu mô hình bên trong để dùng.

B.Nhiều tác vụ sẵn có

README liệt kê các ví dụ mô hình cho nhiều nhóm việc:

  • Âm thanh: nhận dạng giọng nói (như Whisper), phân loại âm thanh, chuyển văn bản thành giọng nói, tạo nhạc.
  • Hình ảnh: phân loại ảnh, phát hiện vật thể, ước lượng độ sâu, phân vùng ảnh.
  • Đa phương thức: hỏi đáp về ảnh, hiểu tài liệu bằng OCR, mô tả ảnh, hỏi đáp trên bảng.
  • Văn bản: tóm tắt, dịch, sinh văn bản, phân loại, hỏi đáp.

Nghĩa là cùng một thư viện, bạn có thể làm việc từ chép lời cuộc họp đến nhận ra món hàng trong ảnh.

C.Chat với mô hình ngay trên dòng lệnh

README có mẹo dùng lệnh transformers chat để trò chuyện trực tiếp với mô hình, miễn là transformers serve đang chạy. Tiện để thử nhanh mà không cần viết code.

D.Tương thích rộng với hệ sinh thái AI

README nói mô hình được định nghĩa trong Transformers sẽ tương thích với phần lớn công cụ huấn luyện (Axolotl, Unsloth, DeepSpeed, FSDP, PyTorch-Lightning...), công cụ chạy mô hình (vLLM, SGLang, TGI...) và các thư viện gần đó (llama.cpp, mlx...). Nếu sau này bạn lớn lên về kỹ thuật, kiến thức học ở đây không bị bỏ phí.

E.Dùng lại mô hình đã huấn luyện, tiết kiệm chi phí

Tác giả nhấn mạnh việc chia sẻ mô hình đã huấn luyện thay vì huấn luyện lại từ đầu, giúp giảm thời gian tính toán và chi phí. Với người dùng thông thường, điều này có nghĩa là bạn lấy mô hình về dùng luôn.

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

Theo README, bạn cần:

  • Python 3.11 trở lên.
  • PyTorch 2.6 trở lên (lệnh cài bên dưới sẽ kéo theo phần PyTorch khi dùng transformers[torch]).
  • Một môi trường ảo Python, tạo bằng venv hoặc uv.
  • Kết nối Internet để tải mô hình từ Hub. Mô hình được tải về và lưu đệm (cache) để lần sau dùng lại.

Tư liệu không ghi yêu cầu cụ thể về RAM, GPU hay dung lượng ổ cứng, và cũng không ghi hệ điều hành nào được hỗ trợ. Lệnh kích hoạt môi trường ảo trong README viết cho macOS/Linux. Mô hình càng lớn thì máy càng phải mạnh, nên khi mới thử hãy chọn mô hình nhỏ.

README không nói cần tài khoản hay API key cho các ví dụ cơ bản. Một số mô hình có thể có điều kiện riêng trên trang của chúng; tư liệu chưa có thông tin chi tiết về việc này.

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

  1. Kiểm tra PythonĐảm bảo máy có Python 3.11 trở lên
  2. Tạo môi trường ảoDùng venv hoặc uv để tách thư viện khỏi phần còn lại của máy
  3. Cài TransformersChạy pip install "transformers[torch]" trong môi trường ảo
  4. Chạy thử pipelineDán đoạn code mẫu sinh văn bản để kiểm tra

A.Kiểm tra phiên bản Python

README yêu cầu Python 3.11+. Mở terminal (PowerShell hoặc Terminal) rồi gõ lệnh sau để xem phiên bản đang có. Lệnh này là lệnh phổ thông của Python, không nằm trong README.

Terminal
python --version

Nếu ra số thấp hơn 3.11, bạn cần cài Python mới hơn trước khi làm tiếp.

B.Tạo và bật môi trường ảo

Môi trường ảo giống một "căn phòng riêng" cho dự án, thư viện cài vào đó không làm lộn xộn máy bạn. README đưa hai cách, chọn một. Cách dùng venv:

Terminal
python -m venv .my-env
source .my-env/bin/activate

Hoặc dùng uv, một công cụ quản lý Python viết bằng Rust, chạy nhanh:

Terminal
uv venv .my-env
source .my-env/bin/activate

Chỗ người mới hay vấp: lệnh source trên là cách bật môi trường trên macOS/Linux. Nếu dùng Windows, README không ghi lệnh tương ứng; bạn xem tài liệu của venv (README có dẫn link tới docs.python.org) để biết cách bật. Khi bật thành công, đầu dòng lệnh thường hiện tên môi trường .my-env.

C.Cài Transformers

Sau khi môi trường đã bật, cài bằng pip:

Terminal
pip install "transformers[torch]"

Hoặc nếu bạn dùng uv:

Terminal
uv pip install "transformers[torch]"

Phần [torch] báo cho pip cài kèm các thành phần cần cho PyTorch. Đừng bỏ dấu ngoặc kép, vì một số terminal hiểu sai dấu ngoặc vuông nếu thiếu chúng.

D.Cài từ mã nguồn (không bắt buộc)

Chỉ làm bước này nếu bạn muốn bản mới nhất hoặc muốn đóng góp cho dự án. README cảnh báo bản mới nhất có thể chưa ổn định.

Terminal
git clone https://github.com/huggingface/transformers.git
cd transformers

# pip
pip install '.[torch]'

# uv
uv pip install '.[torch]'

Lệnh git clone tải toàn bộ mã về máy, cd transformers đi vào thư mục vừa tải, và lệnh pip install ở cuối cài thư viện từ chính thư mục đó. Dấu chấm trước [torch] nghĩa là "thư mục hiện tại", nên bạn phải đứng đúng trong thư mục transformers.

Người dùng bình thường nên cài bằng pip như bước trước. Bản cài từ mã nguồn có thể chưa ổn định, theo chính lời cảnh báo của README.

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

Cách kiểm tra theo README là chạy thử pipeline sinh văn bản. Tạo một file Python (hoặc mở Python trong terminal) và dán:

Python
from transformers import pipeline

pipeline = pipeline(task="text-generation", model="Qwen/Qwen2.5-1.5B")
pipeline("the secret to baking a really good cake is ")

Lần đầu chạy, thư viện sẽ tải mô hình về nên mất một lúc, tuỳ tốc độ mạng. Những lần sau chạy nhanh hơn vì mô hình đã được lưu đệm. Kết quả mong đợi là một danh sách có khoá generated_text, chứa đoạn văn bản nối tiếp câu bạn đưa vào, ví dụ [{'generated_text': 'the secret to baking a really good cake is 1) to use the right ingredients ...'}]. Nội dung cụ thể có thể khác ví dụ trong README. Chỉ cần ra được một đoạn văn bản và không báo lỗi là bạn đã cài thành công.

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

A.Nhân viên văn phòng: chép lời từ file ghi âm

Bối cảnh: bạn có file ghi âm cuộc họp và muốn có bản chữ. README có ví dụ nhận dạng giọng nói bằng mô hình Whisper:

Python
from transformers import pipeline

pipeline = pipeline(task="automatic-speech-recognition", model="openai/whisper-large-v3")
pipeline("https://huggingface.co/datasets/Narsil/asr_dummy/resolve/main/mlk.flac")

Ví dụ trong README dùng một đường link âm thanh mẫu và trả về {'text': ' I have a dream that one day this nation will rise up ...'}. Với file của bạn, hãy thử thay phần đường link bằng đường dẫn tới file âm thanh trên máy; README chưa nói rõ các định dạng được hỗ trợ, nên nếu lỗi hãy xem tài liệu Pipeline mà README dẫn tới. Kết quả là một đoạn chữ bạn có thể sửa lại và gửi cho cả nhóm. Mô hình whisper-large-v3 khá lớn, nên máy yếu có thể chạy chậm.

B.Chủ shop: tự nhận diện nội dung ảnh sản phẩm

Bối cảnh: bạn có nhiều ảnh và muốn máy gợi ý ảnh đó là gì. README có ví dụ phân loại ảnh:

Python
from transformers import pipeline

pipeline = pipeline(task="image-classification", model="facebook/dinov2-small-imagenet1k-1-layer")
pipeline("https://huggingface.co/datasets/Narsil/image_dummy/raw/main/parrots.png")

Kết quả là danh sách các nhãn kèm điểm tin cậy. Với ảnh mẫu, nhãn đứng đầu là macaw với điểm khoảng 0,998. Bạn dùng điểm này để lọc: điểm cao thì tin, điểm thấp thì kiểm tra tay. Lưu ý mô hình này phân loại theo bộ nhãn có sẵn (ImageNet) nên không tự biết sản phẩm riêng của shop bạn; muốn nhận diện đúng hàng của mình thì phải huấn luyện thêm, việc này vượt ngoài phạm vi ví dụ trong README.

Chỉ vài dòng Python là bạn đã có một mô hình AI chạy trên máy của mình.

Ông T

C.Lập trình viên: hỏi đáp về nội dung một bức ảnh

Bối cảnh: bạn đang làm một công cụ cần "nhìn" ảnh rồi trả lời câu hỏi. README có ví dụ hỏi đáp trên ảnh:

Python
from transformers import pipeline

pipeline = pipeline(task="visual-question-answering", model="Salesforce/blip-vqa-base")
pipeline(
    image="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/transformers/tasks/idefics-few-shot.jpg",
    question="What is in the image?",
)

Kết quả mẫu là [{'answer': 'statue of liberty'}]. Bạn đưa vào ảnh và một câu hỏi, nhận lại câu trả lời ngắn. Ví dụ của README dùng câu hỏi tiếng Anh; tư liệu chưa nói mô hình này hỗ trợ tiếng Việt tốt đến đâu.

D.Người mới học: trò chuyện với mô hình ngay trên dòng lệnh

Bối cảnh: bạn muốn thử cảm giác chat với một mô hình mà không viết code. README ghi: có thể chat trực tiếp từ dòng lệnh, miễn là transformers serve đang chạy.

Terminal
transformers chat Qwen/Qwen2.5-0.5B-Instruct

Lệnh này mở phiên trò chuyện với một mô hình nhỏ (0,5 tỷ tham số theo tên mô hình), phù hợp cho máy cấu hình vừa phải. README chưa ghi lệnh khởi động transformers serve kèm cờ nào, nên bạn xem trang hướng dẫn "serving" mà README dẫn tới. Nếu muốn chat bằng code, README cũng có ví dụ dựng lịch sử hội thoại với các vai system và user rồi đưa vào pipeline, dùng mô hình Meta-Llama-3-8B-Instruct. Đó là mô hình lớn hơn nhiều, nên chỉ thử khi máy đủ mạnh.

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

A.Python quá cũ

README yêu cầu Python 3.11+. Nếu máy bạn có bản thấp hơn, pip có thể báo không tìm thấy bản phù hợp hoặc cài lỗi. Chạy python --version để kiểm tra, rồi cài Python mới hơn và tạo lại môi trường ảo.

B.Lệnh source không chạy trên Windows

Dòng source .my-env/bin/activate trong README viết cho macOS/Linux. Trên Windows PowerShell, lệnh này không có tác dụng. Hãy xem tài liệu venv của Python để biết lệnh bật môi trường trên Windows, hoặc dùng WSL nếu bạn đã quen.

C.Báo thiếu PyTorch (torch)

Nếu bạn chỉ chạy pip install transformers mà không có phần [torch], có thể sẽ thiếu PyTorch và gặp lỗi khi chạy mô hình. Hãy cài lại đúng lệnh trong README: pip install "transformers[torch]", và nhớ đang ở trong môi trường ảo đã bật.

D.Máy hết bộ nhớ hoặc chạy rất chậm

Mô hình lớn như Meta-Llama-3-8B-Instruct hay whisper-large-v3 đòi hỏi nhiều tài nguyên. Tư liệu không ghi cấu hình tối thiểu. Cách xử lý an toàn là đổi sang mô hình nhỏ hơn, ví dụ Qwen/Qwen2.5-0.5B-Instruct hoặc Qwen/Qwen2.5-0.5B như trong README, rồi tăng dần.

E.Chờ rất lâu ở lần chạy đầu

Đây thường không phải lỗi. README nói mô hình được tải về và lưu đệm để dùng lại. Lần đầu tải mô hình lớn có thể mất nhiều phút, nhất là khi mạng yếu. Hãy để nó chạy xong; nếu bị ngắt giữa chừng, chạy lại lệnh và kiểm tra tên mô hình đã gõ đúng chưa.

Mô hình tải từ Hub là mã và dữ liệu của bên thứ ba. Hãy chọn mô hình từ nguồn bạn tin tưởng và đọc trang mô tả của mô hình trước khi dùng cho công việc thật. Tư liệu về repo không đi sâu vào vấn đề bảo mật; nếu quan tâm, bạn có thể xem file SECURITY.md trong repo.

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

Điểm mạnh rõ nhất là sự thống nhất và phạm vi rộng. Một thư viện, một cách gọi, hỗ trợ nhiều loại dữ liệu và rất nhiều mô hình có sẵn. Giấy phép Apache-2.0, cộng đồng lớn, repo còn cập nhật đều. Với người mới, pipeline là cửa vào dễ nhất để thấy AI chạy thật trên máy mình, không phải qua một dịch vụ trả phí theo lượt dùng. Repo còn có thư mục examples/ và notebooks/ cho người muốn đi sâu hơn.

Giới hạn cũng cần nói thẳng. Thứ nhất, bạn vẫn phải biết dùng terminal và Python ở mức cơ bản. Thứ hai, README tự nói đây không phải bộ công cụ "lắp ghép khối" cho mạng nơ-ron; code trong file mô hình cố ý không tách thêm tầng trừu tượng để nhà nghiên cứu sửa nhanh. Thứ ba, phần huấn luyện được tối ưu cho các mô hình PyTorch do Transformers cung cấp; với vòng lặp học máy tổng quát, README khuyên dùng thư viện khác như Accelerate. Thứ tư, repo có tệp MIGRATION_GUIDE_V5.md, cho thấy có phiên bản lớn với thay đổi cần chú ý; nếu bạn dùng code cũ viết theo hướng dẫn đời trước, hãy đọc tệp này.

Khi nào nên chọn cách khác? Nếu bạn không biết code và chỉ cần chép lời hay dịch thuật thỉnh thoảng, một ứng dụng đóng gói sẵn sẽ tiện hơn. Nếu máy bạn rất yếu và cần mô hình lớn, một dịch vụ AI trên đám mây có thể hợp lý hơn. Còn nếu bạn muốn học, thử nghiệm, tự động hoá việc riêng bằng Python, Transformers là điểm bắt đầu rất đáng thử.

4.1/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

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

Thư viện là mã nguồn mở theo giấy phép Apache-2.0, bạn cài và dùng không mất phí bản quyền. Tư liệu không nói gì về điều khoản của từng mô hình trên Hub, nên bạn nên đọc trang mô tả của mô hình trước khi dùng cho mục đích thương mại.

Cần những gì để cài Transformers?

Theo README, bạn cần Python 3.11 trở lên và PyTorch 2.6 trở lên. Cách đơn giản là tạo môi trường ảo rồi chạy pip install "transformers[torch]". Tư liệu không nêu yêu cầu cụ thể về RAM hay dung lượng ổ cứng.

Có cần GPU không?

Tư liệu chưa ghi rõ yêu cầu GPU. Ví dụ trong README có dùng tuỳ chọn device_map="auto" cho mô hình lớn, nhưng không nói bắt buộc phải có GPU. Nếu máy yếu, bạn nên bắt đầu với mô hình nhỏ như Qwen2.5-0.5B.

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

README chưa nói rõ về hệ điều hành được hỗ trợ. Lệnh bật môi trường ảo trong README viết cho macOS/Linux, nên trên Windows bạn cần dùng lệnh kích hoạt tương ứng của venv. Bạn xem tài liệu venv của Python để biết cách.

Transformers khác gì so với việc dùng ChatGPT?

ChatGPT là dịch vụ có sẵn, còn Transformers là thư viện để bạn tự tải mô hình về và chạy bằng code. Theo README, thư viện hỗ trợ cả văn bản, ảnh, âm thanh và đa phương thức, cho cả suy luận lẫn huấn luyện. Tư liệu không so sánh trực tiếp chất lượng với dịch vụ nào.

Dữ liệu của tôi có an toàn không?

Tư liệu không có phần mô tả về quyền riêng tư dữ liệu. README chỉ nói mô hình được tải về và lưu đệm để dùng lại. Repo có tệp SECURITY.md nếu bạn muốn xem chính sách bảo mật của dự án.

Tôi có thể chat với mô hình mà không viết code không?

Có một cách theo README: dùng lệnh transformers chat kèm tên mô hình, với điều kiện transformers serve đang chạy. Ví dụ README là transformers chat Qwen/Qwen2.5-0.5B-Instruct. Cách khởi động transformers serve nằm ở trang hướng dẫn serving mà README dẫn tới.

Chuyển nhanh tới mục

  1. I.Transformers làm được gì
    1. A.Một cách gọi chung cho nhiều loại dữ liệu
    2. B.Nhiều tác vụ sẵn có
    3. C.Chat với mô hình ngay trên dòng lệnh
    4. D.Tương thích rộng với hệ sinh thái AI
    5. E.Dùng lại mô hình đã huấn luyện, tiết kiệm chi phí
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Kiểm tra phiên bản Python
    2. B.Tạo và bật môi trường ảo
    3. C.Cài Transformers
    4. D.Cài từ mã nguồn (không bắt buộc)
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Nhân viên văn phòng: chép lời từ file ghi âm
    2. B.Chủ shop: tự nhận diện nội dung ảnh sản phẩm
    3. C.Lập trình viên: hỏi đáp về nội dung một bức ảnh
    4. D.Người mới học: trò chuyện với mô hình ngay trên dòng lệnh
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Python quá cũ
    2. B.Lệnh source không chạy trên Windows
    3. C.Báo thiếu PyTorch (torch)
    4. D.Máy hết bộ nhớ hoặc chạy rất chậm
    5. E.Chờ rất lâu ở lần chạy đầu
  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ỏ.