docling-project / docling-project/docling
Free Community Hosted Instance of Docling-Serve on Hugging Face Spaces
- 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! 📄✨
Contributor guide
Assessment
This issue has not been assessed yet.