Spaces:
Sleeping
Sleeping
| title: GROBID | |
| emoji: 📚 | |
| colorFrom: purple | |
| colorTo: green | |
| sdk: docker | |
| app_port: 8070 | |
| pinned: false | |
| license: apache-2.0 | |
| fullWidth: true | |
| short_description: GROBID — scholarly PDF to structured TEI XML | |
| # GROBID on a Hugging Face Docker Space | |
| GROBID (GeneRation Of BIbliographic Data) turns scholarly PDFs into structured **TEI XML** — | |
| header (title/authors/affiliations/abstract), body full text, and parsed bibliography. | |
| Deployed for the `psychoguineapig.com` box, which retired GROBID locally on 2026-10-09 because | |
| the JVM was the heaviest memory consumer on the host (1.26 GiB RAM + 1.63 GiB swap) and nothing | |
| was calling it. Here it runs on Hugging Face free CPU compute instead — no RAM on our box, no | |
| GPU quota spent. | |
| ## Image choice | |
| `grobid/grobid:0.9.1-crf` — the CRF-only image, **0.51 GB** on disk. The `-full` image is | |
| 14.8 GB and is documented as wanting a GPU for reasonable runtime; free CPU Basic Spaces have | |
| no GPU (2 vCPU / 16 GB RAM), so CRF is the correct trade: it is the recommended image for | |
| fulltext/RAG pre-processing. | |
| ## Endpoints | |
| - `https://strangerinastrangeland-grobid.hf.space/api/isalive` — health | |
| - `/api/processFulltextDocument` (multipart PDF) — header + body + references | |
| - `/api/processHeaderDocument` — metadata only (cheapest, ~2 GB RAM) | |
| - `/api/processReferences` — bibliography only | |
| Interactive console: `https://strangerinastrangeland-grobid.hf.space/` | |
| ## Notes | |
| - Recipe mirrors the long-standing `kermitt2/grobid` Space: vendor image, root, writable | |
| `grobid-home/tmp`, explicit `grobid-service` CMD. ~20 GROBID Spaces exist on the Hub. | |
| - HF Spaces cannot set `--init` / `--ulimit core=0` (which GROBID's C++ PDF parser normally | |
| wants). If the container dies on a malformed PDF, that is the first suspect. | |
| - Free CPU Basic Spaces sleep after 48 h idle; the next request wakes them (~30 s cold start). | |