hudoc - HUDOC Downloader

Human rights standards from the European Court of Human Rights (ECHR) and expert bodies like GREVIO often inform family and social law cases in member states. HUDOC provides key judgments and reports—vital for grasping relevant reasoning and positions.

hudoc downloads cases from HUDOC subsites (ECHR, GREVIO, etc.) via RSS feeds. Saves as plain text or evid format for labeling/citation.

Why hudoc?

• Bulk access to CoE jurisprudence.
• Evid-ready: Typst/YAML for evid workflow.
• Parallel downloads, conversion handling.
• Local: No API keys needed.

Features

• Auto-detects subsite (echr, grevio, etc.).
• Plain text or evid (label.typ + info.yml).
• Limit/threads control.
• RSS listing/stats.

Install

uv pip install https://github.com/evidlabel/hudoc.git
hudoc -h

Usage

1. Download RSS from HUDOC front pages: https://hudoc.echr.coe.int (or subsites like hudoc.grevio.coe.int).

# List items
hudoc list echr.rss

# Download (evid format default)
hudoc download echr.rss -o data/ -l 5 -n 10

# Plain text
hudoc download echr.rss -o data/ -l 5 --plain

Example Output (evid)

Per doc: data/<uuid>/label.typ + info.yml

#import "@local/labtyp:0.1.0": lablist
#mset(...)  // Metadata

= ECHR-001-...

[Case text...]

GitHub