DEPLOYMENT.md

Hướng dẫn Deploy lên Hugging Face Spaces

Bước 1: Chuẩn bị Repository

1. Tạo một Space mới trên Hugging Face: https://huggingface.co/new-space
2. Chọn SDK: Streamlit
3. Clone repository về máy hoặc upload files

Bước 2: Upload Files

Upload các files sau lên repository:

├── main.py                     # File chính của ứng dụng
├── requirements.txt            # Dependencies Python
├── README.md                   # Metadata cho HF Spaces
├── Dockerfile                  # Tùy chọn: để custom container
├── .streamlit/
│   ├── config.toml            # Cấu hình Streamlit
│   └── secrets.example.toml   # Mẫu file secrets
├── .env                       # Environment variables
└── .dockerignore              # Ignore files cho Docker

Bước 3: Cấu hình Environment Variables

Trong Hugging Face Spaces Settings, thêm:

• API_BASE_URL: URL của API backend (ví dụ: https://your-api.com)

Bước 4: Deploy

1. Push code lên repository
2. Hugging Face sẽ tự động build và deploy
3. Kiểm tra logs nếu có lỗi

Lưu ý:

• Port mặc định cho HF Spaces: 7860
• App sẽ tự động restart khi có thay đổi code
• Có thể monitor logs trong tab "Logs" của Space

Troubleshooting:

1. API connection issues: Kiểm tra API_BASE_URL trong settings
2. Import errors: Kiểm tra requirements.txt
3. Port issues: Đảm bảo app chạy trên port 7860