docling-project / docling-project/docling

Free Community Hosted Instance of Docling-Serve on Hugging Face Spaces

Open
#3,018 0 comments 1 reaction 0 assignees View on GitHub
enhancement triage/close-stale
Dominant language
Python
Stars
66.4k
Forks
4.8k
Avg merge
2d 21h
Merged PRs (30d)
84

Description

Hi everyone! 👋

I'm a big fan of `docling` and `docling-serve`. To make it easier for the community to quickly test and experiment with document parsing without setting up local infrastructure, I've deployed a **free, public Hugging Face Space** running `docling-serve`:

**🚀 Live Space:** [Bibyutatsu/HF-docling-serve](https://huggingface.co/spaces/Bibyutatsu/HF-docling-serve)
**📖 Swagger Docs:** [API Docs](https://bibyutatsu-hf-docling-serve.hf.space/docs)
**䷛ Github Repo** [Github Repo](https://github.com/Bibyutatsu/HF-docling-serve)

It runs the official Docker image (`ghcr.io/docling-project/docling-serve:latest`) on HF's Free Docker Tier (2 vCPU, 16GB RAM) with a thin wrapper that adds:
- ✅ Root `/` redirect for HF Spaces health checks
- ✅ Per-IP rate limiting (2 req/min on heavy endpoints)
- ✅ Global concurrency control (max 3 simultaneous tasks)

### Quick Example

```python
import requests

response = requests.post(
"https://Bibyutatsu-HF-docling-serve.hf.space/v1/convert/source",
json={"sources": [{"kind": "http", "url": "https://arxiv.org/pdf/2501.17887"}]}
)
print(response.json()['document']['md_content'])
```

### Fair-Use Limits

| Limit | Value |
|---|---|
| Per-IP Rate Limit | 2 requests / minute on `/v1/convert/*` and `/v1/chunk/*` |
| Global Concurrency | Max 3 simultaneous heavy processing tasks |
| Cold Start | ~2–5 min after 48h inactivity (free tier sleep) |

For heavier workloads, the **async endpoints** (`/v1/convert/source/async`) queue efficiently and avoid timeouts.

### Purpose

This is meant to help people quickly evaluate `docling`'s layout detection, table extraction, and OCR capabilities on their own documents — without standing up their own infrastructure. The source repo with the Dockerfile and wrapper is here: [Bibyutatsu/HF-docling-serve](https://github.com/Bibyutatsu/HF-docling-serve).

Would love to know if this could be useful to link from the community docs or README! Thanks again for the incredible work on this project! 📄✨

Image

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.