Spaces:
Runtime error
Runtime error
Update README.md
Browse files
README.md
CHANGED
|
@@ -1,30 +1,29 @@
|
|
| 1 |
-
#
|
| 2 |
|
| 3 |
-
|
| 4 |
|
| 5 |
-
##
|
| 6 |
-
1. Create an environment with `Python == 3.9.19`
|
| 7 |
-
2. Install `Pytorchvideo`
|
| 8 |
-
```
|
| 9 |
-
cd src/libs
|
| 10 |
-
git clone https://github.com/facebookresearch/pytorchvideo.git
|
| 11 |
-
pip install -e pytorchvideo
|
| 12 |
-
```
|
| 13 |
-
3. Install other requirements
|
| 14 |
-
```
|
| 15 |
-
cd ../..
|
| 16 |
-
pip install -r requirements.txt
|
| 17 |
-
```
|
| 18 |
|
| 19 |
-
|
| 20 |
-
|
| 21 |
-
|
| 22 |
-
|
| 23 |
-
|
| 24 |
-
|
| 25 |
-
|
| 26 |
-
|
| 27 |
-
|
| 28 |
-
|
| 29 |
-
|
| 30 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# Sign Language Inference API
|
| 2 |
|
| 3 |
+
Đây là dự án triển khai inference của mô hình nhận dạng cử chỉ/ngôn ngữ ký hiệu thông qua video, sử dụng FastAPI và triển khai trên Hugging Face Spaces.
|
| 4 |
|
| 5 |
+
## Mục đích
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 6 |
|
| 7 |
+
- Cho phép người dùng upload video và nhận kết quả nhận dạng cử chỉ.
|
| 8 |
+
- Hỗ trợ nhiều kiến trúc mô hình: `dsta_slr`, `sl_gcn`, `spoter`.
|
| 9 |
+
- Cho phép lựa chọn output gồm:
|
| 10 |
+
- `predictions`: Chỉ trả về kết quả dự đoán.
|
| 11 |
+
- `csv`: Trả về đường dẫn tới file kết quả `results.csv`.
|
| 12 |
+
- `video`: Trả về đường dẫn tới video đầu ra có vẽ skeleton và chú thích.
|
| 13 |
+
- `all`: Trả về tất cả các kết quả trên.
|
| 14 |
+
|
| 15 |
+
## Cấu trúc dự án
|
| 16 |
+
|
| 17 |
+
- `app.py`: File chính chạy FastAPI API.
|
| 18 |
+
- `configs.py`: Định nghĩa các lớp cấu hình `ModelConfig`, `InferenceConfig`.
|
| 19 |
+
- `data.py`, `tools.py`, `utils.py`, `visualization.py`: Các tiện ích, xử lý pose, pipeline inference.
|
| 20 |
+
- `requirements.txt`: Danh sách các thư viện cần thiết.
|
| 21 |
+
- `Dockerfile`: Định nghĩa môi trường Docker để deploy lên Hugging Face Spaces (nếu sử dụng chế độ Docker).
|
| 22 |
+
|
| 23 |
+
## Cách cài đặt và chạy (Local)
|
| 24 |
+
|
| 25 |
+
1. Tạo và kích hoạt môi trường ảo (tùy chọn):
|
| 26 |
+
```bash
|
| 27 |
+
python3 -m venv venv
|
| 28 |
+
source venv/bin/activate # Trên Linux/macOS
|
| 29 |
+
venv\Scripts\activate # Trên Windows
|