| # 🧪 DocStrange API Deployment Guide |
|
|
| ## 📦 **Files in This Folder** |
|
|
| - `app.py` - FastAPI application for DocStrange extraction |
| - `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**: `docstrange-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/docstrange-api |
| cd docstrange-api |
| cp app.py requirements.txt Dockerfile . |
| git add . |
| git commit -m "Deploy DocStrange API" |
| git push |
| ``` |
|
|
| ## 🧪 **Test Your Deployment** |
|
|
| ```bash |
| cd test-scripts |
| python test_docstrange.py https://YOUR_USERNAME-docstrange-api.hf.space |
| ``` |
|
|
| ## 📡 **API Documentation** |
|
|
| Once deployed, visit: `https://YOUR_USERNAME-docstrange-api.hf.space/docs` |
|
|
| ## 🔧 **Endpoints** |
|
|
| - `GET /` - Health check |
| - `POST /extract` - Full document extraction |
| - `POST /extract/markdown` - Markdown/text only |
| - `POST /extract/tables` - Tables only |
|
|
| ## 💡 **Tips** |
|
|
| - DocStrange supports GPU mode if available |
| - Automatic GPU detection in the API |
| - Works with any document format (PDF, DOCX, Images, etc.) |
|
|
