Chuyển đến nội dung

gradio-app / gradio

Gradio

Tạo giao diện web cho mô hình AI hoặc hàm Python trong vài dòng code và chia sẻ bằng một đường link

Gradio là thư viện Python để dựng nhanh giao diện web cho mô hình học máy, API hay bất kỳ hàm Python nào: ô nhập chữ, tải ảnh, ghi âm, nút gửi, ô kết quả. Có thể tạo link công khai tạm thời để gửi cho người khác dùng thử. Rất nhiều công cụ AI mã nguồn mở có giao diện web chạy trên Gradio, nên biết về nó giúp bạn hiểu và chỉnh các công cụ đó.

  • 44.064 sao
  • 3.669 fork
  • Python
  • Cập nhật 3 ngày trước
  • Apache 2.0 (dùng tự do, kể cả thương mại)
Độ khó
Vừa Cần gõ vài lệnh hoặc dùng Docker
Dạng
Thư viện lập trình
Chạy trên
Windows, macOS, Linux, Python
Chi phí
Miễn phí hoàn toàn

Trải nghiệm khi dùng Gradio

Bạn cài Gradio bằng pip, rồi viết một hàm Python bình thường, ví dụ nhận tên và trả lời lời chào. Bọc hàm đó bằng gr.Interface, nêu loại đầu vào và đầu ra, gọi launch(). Chạy file và một trang web mở ra tại địa chỉ cục bộ, có ô nhập, thanh trượt và nút gửi.

Điểm đặc biệt là chia sẻ: thêm share=True vào lệnh khởi chạy, Gradio tạo một đường link công khai để bạn gửi cho đồng nghiệp hay bạn bè dùng thử ngay trên máy bạn, không cần thuê máy chủ. Link này chỉ nên dùng tạm thời để demo.

Với các dự án lớn hơn như giao diện chat, ứng dụng nhiều tab, Gradio có thêm các lớp cấp cao và hơn 30 loại thành phần dựng sẵn cho ảnh, âm thanh, video, bảng. Nhiều dự án AI bạn từng cài, từ giao diện tạo ảnh đến công cụ giọng nói, chính là một chương trình Gradio như vậy.

Tính năng nổi bật

Từ hàm Python ra giao diện web

Chỉ cần nói hàm nhận gì và trả gì, Gradio dựng giao diện tương ứng.

Hơn 30 thành phần dựng sẵn

Ô chữ, ảnh, âm thanh, video, bảng, biểu đồ... dùng chung cho nhiều loại mô hình.

Chia sẻ bằng link công khai

Đặt share=True để nhận link dạng gradio.live gửi cho người khác dùng thử.

Chạy ở mọi nơi viết Python

Dùng trong trình soạn code, Jupyter Notebook, Google Colab hay máy chủ.

Tải lại tự động khi sửa code

Gõ gradio app.py thay cho python app.py để trang cập nhật ngay mỗi khi bạn lưu file.

Tự có API cho ứng dụng

Ứng dụng Gradio cũng gọi được như một API, nên chương trình khác dùng được kết quả.

Tận dụng Gradio vào việc gì?

Kỹ sư dữ liệu, sinh viên

Cho đồng nghiệp thử mô hình bạn vừa làm

Đóng gói mô hình phân loại ảnh sản phẩm thành giao diện kéo thả, gửi link cho người không biết code thử luôn.

Dân văn phòng biết Python

Làm công cụ nhỏ xử lý file hàng ngày

Bọc một script đổi tên file, trích dữ liệu từ PDF thành giao diện với nút bấm cho cả phòng dùng.

Lập trình viên, người làm AI

Dựng giao diện chatbot thử nghiệm

Làm khung chat để thử mô hình ngôn ngữ trước khi làm giao diện chính thức.

Người dùng nâng cao

Hiểu và chỉnh các công cụ AI có sẵn

Nhiều công cụ tạo ảnh, giọng nói mã nguồn mở có UI Gradio; biết cơ chế giúp bạn đổi cổng, bật chia sẻ hay sửa giao diện.

Cần chuẩn bị gì?

  • Python 3.10 trở lên (theo README).
  • Python và pip, nên dùng môi trường ảo.
  • Trình duyệt web để xem ứng dụng.
  • Muốn dùng link chia sẻ cần có kết nối Internet.

Hướng dẫn cài đặt chi tiết

Cài trên pip

  1. Tạo môi trường ảo cho dự án, sau đó cài hoặc nâng cấp Gradio bằng lệnh trong README.

    Terminal
    python -m venv .venv
    pip install --upgrade gradio
  2. Kiểm tra bằng cách chạy ví dụ ở mục dùng thử bên dưới.

Dùng thử lần đầu

  1. Tạo file app.py với ví dụ đầu tiên trong README.

    Python
    import gradio as gr
    
    def greet(name, intensity):
        return "Hello, " + name + "!" * int(intensity)
    
    demo = gr.Interface(
        fn=greet,
        inputs=["text", "slider"],
        outputs=["text"],
        api_name="predict"
    )
    
    demo.launch()
  2. Chạy file. README nói trang sẽ mở tại http://localhost:7860 khi chạy từ file.

    Terminal
    python app.py
  3. Nhập tên, kéo thanh trượt rồi bấm nút gửi để thấy lời chào hiện bên phải.

  4. Chạy bằng chế độ tải lại nóng để mỗi lần lưu file là trang cập nhật.

    Terminal
    gradio app.py
  5. Thử chia sẻ: đổi dòng cuối thành demo.launch(share=True) và gửi đường link được in ra cho người khác.

Mẹo dùng hay

  • Khi đổi cổng hay địa chỉ lắng nghe cho công cụ AI dùng Gradio, thường chỉ cần biến môi trường GRADIO_SERVER_PORT và GRADIO_SERVER_NAME (ví dụ kotaemon dùng chúng).
  • Link chia sẻ gradio.live chạy trên máy bạn; tắt chương trình là link hết hiệu lực.
  • Với giao diện nhiều bước hoặc nhiều tab, tìm hiểu gr.Blocks trong tài liệu thay vì gr.Interface.

Lưu ý và hạn chế

  • Link chia sẻ công khai cho phép bất kỳ ai có link dùng ứng dụng trên máy bạn; đừng chia sẻ khi hàm có thể đọc file hay xử lý dữ liệu nhạy cảm, và nên đặt mật khẩu nếu cần.
  • Giao diện hợp với demo và công cụ nội bộ; sản phẩm thương mại tuỳ biến sâu thường cần giao diện riêng.
  • Cần biết Python cơ bản; không phải ứng dụng bấm chuột cài sẵn.

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

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

Có, mã nguồn mở giấy phép Apache-2.0. Chạy trên máy bạn không tốn phí; chỉ phát sinh chi phí nếu bạn thuê máy chủ để đăng lâu dài.

Cần biết web không?

Không, README nhấn mạnh không cần JavaScript, CSS hay hosting; chỉ cần Python.

Khác gì Streamlit?

Gradio rất hợp để demo mô hình với đầu vào và đầu ra rõ ràng như ảnh, âm thanh. Streamlit hợp hơn với dashboard và ứng dụng dữ liệu nhiều thành phần.

Tải mã nguồn về máy

Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.

Terminal
git clone https://github.com/gradio-app/gradio.git

Repo tương tự nên xem

Thư viện & framework AI46,4K

Streamlit

streamlit / streamlit

Biến một file Python thành ứng dụng web dữ liệu, dashboard hay chatbot mà không cần biết web

VừaWindowsmacOSLinuxPython
Thư viện & framework AI169K

Hugging Face Transformers

huggingface / transformers

Thư viện Python để tải và chạy hàng triệu mô hình AI từ Hugging Face chỉ với vài dòng code

KhóWindowsmacOSLinuxPython
Tạo ảnh & video bằng AI53,9K

Fooocus

lllyasviel / Fooocus

Tạo ảnh AI kiểu Midjourney ngay trên máy bạn, chỉ cần gõ mô tả, ít phải chỉnh thông số

DễWindowsLinuxmacOSPython

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: Thư viện & framework AI

Thư viện & framework AI202K

TensorFlow

tensorflow / tensorflow

Nền tảng học máy của Google để xây, huấn luyện và triển khai mô hình AI bằng Python

KhóWindowsmacOSLinuxDocker+1
Thư viện & framework AI150K

LangChain

langchain-ai / langchain

Thư viện Python giúp lập trình viên ráp ứng dụng và agent chạy bằng AI từ các mảnh ghép dựng sẵn

KhóPython
Thư viện & framework AI106K

PyTorch

pytorch / pytorch

Thư viện học sâu phổ biến nhất giới nghiên cứu, tính toán tensor trên GPU và huấn luyện mạng nơ-ron

KhóWindowsmacOSLinuxDocker+1
Thư viện & framework AI91,6K

OpenCV

opencv / opencv

Thư viện thị giác máy tính kinh điển: xử lý ảnh, video, nhận diện khuôn mặt, vật thể

KhóWindowsmacOSLinuxAndroid+2
Thư viện & framework AI79,6K

Unsloth

unslothai / unsloth

Ứng dụng chạy và tinh chỉnh mô hình AI trên máy mình, tiết kiệm VRAM và nhanh hơn

VừaWindowsmacOSLinuxDocker+1
Thư viện & framework AI76,1K

LLaMA-Factory

hiyouga / LlamaFactory

Tinh chỉnh hơn 100 mô hình ngôn ngữ qua giao diện web hoặc dòng lệnh, gần như không cần viết code

KhóWindowsLinuxDockerPython

Xem cả 14 repo Thư viện & framework AI Về Kho Repo