docling-api/README.md

🔬 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

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

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