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