Spaces:
Sleeping
Sleeping
Update README.md
Browse files
README.md
CHANGED
|
@@ -10,4 +10,52 @@ pinned: false
|
|
| 10 |
short_description: Search your favourite Huggingface Repo or Space!
|
| 11 |
---
|
| 12 |
|
| 13 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 10 |
short_description: Search your favourite Huggingface Repo or Space!
|
| 11 |
---
|
| 12 |
|
| 13 |
+
# Hugging Face Repo & Space Searcher
|
| 14 |
+
|
| 15 |
+
Ứng dụng Gradio này cho phép bạn tìm kiếm và xem tất cả thông số chi tiết của một Model Repository hoặc một Space trên Hugging Face. Nó cũng cung cấp một ước tính về xếp hạng của repo/space đó dựa trên số lượt thích.
|
| 16 |
+
|
| 17 |
+
## 🚀 Cách thiết lập và chạy
|
| 18 |
+
|
| 19 |
+
### Bước 1: Tạo một Hugging Face Space mới
|
| 20 |
+
|
| 21 |
+
1. Truy cập [Hugging Face Spaces](https://huggingface.co/spaces).
|
| 22 |
+
2. Nhấn vào **"Create new Space"**.
|
| 23 |
+
3. Đặt tên cho Space của bạn.
|
| 24 |
+
4. Chọn **"Gradio"** làm SDK.
|
| 25 |
+
5. Chọn **"Public"** hoặc **"Private"** tùy theo nhu cầu.
|
| 26 |
+
6. Bạn có thể để trống phần "Space template" hoặc chọn một template đơn giản.
|
| 27 |
+
|
| 28 |
+
### Bước 2: Thêm Secret `HF_TOKEN`
|
| 29 |
+
|
| 30 |
+
Đây là bước quan trọng nhất để ứng dụng có thể truy cập API của Hugging Face.
|
| 31 |
+
|
| 32 |
+
1. Trong trang Space của bạn, đi đến tab **"Settings"**.
|
| 33 |
+
2. Kéo xuống phần **"Repository secrets"**.
|
| 34 |
+
3. Nhấn vào **"New secret"**.
|
| 35 |
+
4. Trong ô **"Name"**, nhập chính xác: `HF_TOKEN`
|
| 36 |
+
5. Trong ô **"Value"**, dán **Hugging Face Access Token** của bạn.
|
| 37 |
+
* Để lấy token, truy cập [Hugging Face Settings > Access Tokens](https://huggingface.co/settings/tokens).
|
| 38 |
+
* Tạo một token mới với vai trò là **"read"**. Đây là quyền tối thiểu cần thiết và an toàn nhất cho ứng dụng này.
|
| 39 |
+
6. Nhấn **"Save secret**".
|
| 40 |
+
|
| 41 |
+
### Bước 3: Tải lên các file
|
| 42 |
+
|
| 43 |
+
Tải 3 file `app.py`, `requirements.txt`, và `README.md` này lên repository của Space bạn vừa tạo. Hugging Face sẽ tự động phát hiện `requirements.txt` và cài đặt các thư viện cần thiết, sau đó chạy `app.py`.
|
| 44 |
+
|
| 45 |
+
Sau một vài phút, ứng dụng của bạn sẽ sẵn sàng để sử dụng!
|
| 46 |
+
|
| 47 |
+
## 📖 Cách sử dụng
|
| 48 |
+
|
| 49 |
+
1. Mở ứng dụng Gradio trên URL của Space.
|
| 50 |
+
2. Trong ô "Nhập ID Repo/Space", gõ ID của model hoặc space bạn muốn tìm kiếm.
|
| 51 |
+
* **Ví dụ Model:** `meta-llama/Llama-2-7b-chat-hf`
|
| 52 |
+
* **Ví dụ Space:** `multimodalart/stable-diffusion-xl`
|
| 53 |
+
3. Chọn loại bạn muốn tìm kiếm: "Repository" hoặc "Space".
|
| 54 |
+
4. Nhấn nút "Tìm kiếm".
|
| 55 |
+
5. Kết quả tóm tắt, xếp hạng và thông số chi tiết (dưới dạng JSON) sẽ được hiển thị.
|
| 56 |
+
|
| 57 |
+
## ⚠️ Lưu ý về Xếp hạng
|
| 58 |
+
|
| 59 |
+
- Xếp hạng được ước tính bằng cách kiểm tra xem repo/space có nằm trong **top 100** được yêu thích nhất hay không.
|
| 60 |
+
- Đây là phương pháp hiệu quả về mặt hiệu suất vì việc lấy toàn bộ danh sách và sắp xếp sẽ rất chậm.
|
| 61 |
+
- Nếu không nằm trong top 100, ứng dụng sẽ hiển thị số lượt thích của nó.
|