File size: 1,374 Bytes
ad5d213 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 | # 🔬 Docling API Deployment Guide
## 📦 **Files in This Folder**
- `app.py` - FastAPI application for document conversion
- `requirements.txt` - Python dependencies
- `Dockerfile` - Container configuration
## 🚀 **Deploy to Hugging Face**
### **Method 1: Via Web UI (Easiest)**
1. Go to **https://huggingface.co/spaces**
2. Click **Create new Space**
3. **Name**: `docling-api`
4. **SDK**: `Docker**
5. **Visibility**: `Public` (free) or `Private` (needs token)
6. Click **Create Space**
7. Upload `app.py` and `requirements.txt`
8. Wait 3-5 minutes for deployment
### **Method 2: Via Git**
```bash
git clone https://huggingface.co/spaces/YOUR_USERNAME/docling-api
cd docling-api
cp app.py requirements.txt Dockerfile .
git add .
git commit -m "Deploy Docling API"
git push
```
## 🧪 **Test Your Deployment**
```bash
cd test-scripts
python test_docling.py https://YOUR_USERNAME-docling-api.hf.space
```
## 📡 **API Documentation**
Once deployed, visit: `https://YOUR_USERNAME-docling-api.hf.space/docs`
## 🔧 **Endpoints**
- `GET /` - Health check
- `POST /convert` - Full document conversion
- `POST /convert/markdown` - Markdown only
- `POST /convert/tables` - Tables only
## 💡 **Tips**
- Start with **Free CPU tier** for testing
- Upgrade to **T4 GPU** for production (faster, handles large PDFs)
- Keep PDFs under 10MB for best performance
|