codllm / README.md
NoHaxRelax's picture
codllm deploy
codLLM serving app
d9af91d
|
Raw History Blame Contribute Delete
2.12 kB
metadata
title: codLLM
emoji: 📜
colorFrom: red
colorTo: yellow
sdk: docker
app_port: 7860
pinned: false
short_description: ICD-10h coding for historical causes of death

codLLM

Assigns ICD-10h codes to free-text causes of death from historical death registers (roughly 1850-1939), and routes the records it is unsure about to a human instead of guessing.

Upload a register (CSV, TSV, or any delimited text file), confirm which columns hold the cause, age, and sex, and the model codes the distinct causes. Confident predictions are accepted automatically; the uncertain minority goes to a review queue ordered so the most frequent strings come first, because one decision there can settle thousands of rows.

Access

Open to everyone, no login. The Space sleeps after half an hour without visitors, so the first visit after a quiet spell waits a few minutes while the model loads.

How to cite

If you publish work that uses codes from codLLM, please cite both:

Lunøe, E. D., & Mortensen, L. E. B. (2026). codLLM: ICD-10h coding for historical causes of death [Computer software]. https://huggingface.co/spaces/NoHaxRelax/codllm

Mortensen, L. E. B., & Lunøe, E. D. (2026). Automated historical cause-of-death coding using fine-tuned language models [Bachelor's thesis, Technical University of Denmark]. https://github.com/murrodroid/codLLM

Notes

  • Coding runs as a background job, so a large register does not sit inside a single HTTP request. Results stream back most-frequent-first.
  • Registers uploaded here are processed on this server, not in your browser. They are held in memory only while being coded and are never stored or used for training.
  • The model is sensitive to input format. Cause-only is sent as a bare string; cause+age+sex always sends all three fields, using unknown where a value is missing. Which format works better is source dependent, so both are offered and the exact string being sent is shown before anything is coded.
  • Low uncertainty is not a guarantee of correctness. Sub-code choices may follow a different archive's convention than yours.