https://github.com/vintasoftware/icd-ai-poc

Leverages OpenAI's API to sort ICD-10 codes into different categories
https://github.com/vintasoftware/icd-ai-poc

Last synced: 10 months ago
JSON representation

Leverages OpenAI's API to sort ICD-10 codes into different categories

• Host: GitHub
• URL: https://github.com/vintasoftware/icd-ai-poc
• Owner: vintasoftware
• License: mit
• Created: 2025-04-16T18:47:47.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-07-28T12:23:54.000Z (12 months ago)
• Last Synced: 2025-07-28T14:31:07.120Z (12 months ago)
• Language: TypeScript
• Size: 1.39 MB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# ICD-10 AI Code Search

Welcome! This is a proof of concept that looks to leverage AI to sort ICD-10 codes into either Problems or Allergies. This example comes from a real need we identified in one of our projects and we decided to make it public so the whole community can benefit from the experiment.

## Demo video

[![Sorting ICD-10 into categories with AI](http://img.youtube.com/vi/evU1zOTS8Bg/0.jpg)](http://www.youtube.com/watch?v=evU1zOTS8Bg "Sorting ICD-10 into categories with AI")

## How to run the example

1. Clone the repository.

2. Set up a `.env` file with your OpenAI API key.

3. Run the project with `npm run dev`.

4. Access it at `localhost:3000`.

## Important considerations

### AI models

Different OpenAI models were tested during the development of this proof of concept, here are the ones that were considered:

- GPT-4 Turbo

- GPT-4.1

- GPT-4.5 Preview

- o3-mini

- o1

After manual testing, we found that o1 model produced the most consistent results.

### Production use

This is not a production-ready solution. EHR development demands caution, as mistakes can have serious consequences for patients and providers. However, this can be used as an experimental feature provided that:

- You implement code to verify that the AI’s filtered results are correct and present in the original list.

- Users can always access the full, unfiltered list from your chosen ICD-10 source.

Enjoy!

## Commercial Support

[![Vinta Software Logo](https://avatars2.githubusercontent.com/u/5529080?s=80&v=4 "Vinta Logo")](https://www.vintasoftware.com/)

This is an open-source project maintained by [Vinta Software](https://www.vinta.com.br/). We are always looking for exciting work! If you need any commercial support, feel free to get in touch: contact@vinta.com.br