explaingit

patriciomacadden/icd

Analysis updated 2026-07-12 · repo last pushed 2015-12-02

8RubyAudience · developerComplexity · 2/5DormantSetup · easy

TLDR

A searchable web app for the WHO International Classification of Diseases. Browse disease codes in English/Spanish or get them as JSON data for your own healthcare software.

Mindmap

mindmap
  root((repo))
    What it does
      Search disease codes
      Browse in browser
      JSON API access
    Data
      English and Spanish
      WHO ICD codes
      Pre-built database files
    Use cases
      Patient records systems
      Insurance claims tools
      Medical software lookup
    Status
      No longer maintained
      Replaced by icd.json
    Tech stack
      Ruby
      Web application
      Pentaho Data Integration
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Build a patient records system where doctors can search for and select standardized diagnosis codes.

USE CASE 2

Create an insurance claims tool that matches conditions to official WHO classifications.

USE CASE 3

Pull disease classification data into your healthcare app via the JSON API.

USE CASE 4

Browse ICD disease codes and chapters interactively through a web interface.

What is it built with?

RubyPentaho Data-Integration

How does it compare?

patriciomacadden/icdmitchellh/minitest-speedkrausefx/brewfile
Stars889
LanguageRubyRubyRuby
Last pushed2015-12-022011-09-152017-03-09
MaintenanceDormantDormantDormant
Setup difficultyeasyeasyeasy
Complexity2/52/51/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Ruby web app with pre-built database files included, also requires Pentaho Data-Integration only if you need to update the disease data.

In plain English

This project, called ICD, lets you search and browse the World Health Organization's International Classification of Diseases. It's a standardized list of medical codes and descriptions that healthcare systems worldwide use to categorize diseases, symptoms, and treatments. The tool provides this data in both English and Spanish, and you can look up conditions either through a web browser or by pulling the data programmatically. At its core, the project is a web application built with Ruby. It comes with ready-to-use database files containing all the disease classifications, so after a quick setup you get a searchable website. You can click through chapters and specific disease codes in your browser, or if you're building software that needs to reference these codes, you can append ".json" to any URL to get the data back in a format your application can read. For updating the underlying data, the project uses a tool called Pentaho Data-Integration to process new files from the WHO. This would be useful for anyone building healthcare or medical software who needs their application to understand ICD codes. For example, if you're creating a patient records system and need doctors to select a standardized diagnosis code, or if you're building an insurance claims tool that needs to match conditions to their official WHO classifications, this gives you both the data and a way to serve it. The API makes it straightforward to pull disease information into your own product. One important thing to note is that this repository is no longer maintained. The creator points users to a separate project called icd.json instead. So if you're considering using this today, you'd want to look at the replacement project first, as it likely offers the same disease classification data in a more current and supported form.

Copy-paste prompts

Prompt 1
Help me set up the ICD Ruby web app locally and start searching for WHO disease codes in English and Spanish.
Prompt 2
Show me how to fetch ICD disease data as JSON from this app by appending .json to URLs so I can integrate it into my healthcare software.
Prompt 3
Guide me through replacing this unmaintained ICD project with the icd.json replacement, including how to migrate my existing code that fetches disease classifications.

Frequently asked questions

What is icd?

A searchable web app for the WHO International Classification of Diseases. Browse disease codes in English/Spanish or get them as JSON data for your own healthcare software.

What language is icd written in?

Mainly Ruby. The stack also includes Ruby, Pentaho Data-Integration.

Is icd actively maintained?

Dormant — no commits in 2+ years (last push 2015-12-02).

How hard is icd to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is icd for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.