<div align="center" style="margin-bottom: 1em;">
# HealthChain 💫 🏥
<img src="https://raw.githubusercontent.com/dotimplement/HealthChain/main/docs/assets/images/healthchain_logo.png" alt="HealthChain Logo" width=300></img>
<!-- Project Badges -->
[![PyPI Version][pypi-version-badge]][pypi]
[![Stars][stars-badge]][stars]
[![Downloads][downloads-badge]][pypistats]
[![License][license-badge]][license]
[![Python Versions][python-versions-badge]][pypi]
[![Build Status][build-badge]][build]
[![Substack][substack-badge]][substack]
[![Discord][discord-badge]][discord]
</div>
<h2 align="center" style="border-bottom: none">Open-Source Framework for Productionizing Healthcare AI</h2>
<div align="center">
HealthChain is an open-source developer framework to build healthcare AI applications with native protocol understanding. Skip months of custom integration with **built-in FHIR support**, **real-time EHR connectivity**, and **production-ready deployment** - all in Python.
</div>
## Installation
```bash
pip install healthchain
```
## Core Features
HealthChain is the **quickest way for AI/ML engineers to integrate their models with real healthcare systems**.
### 💡 For HealthTech Engineers
<table>
<tr>
<td width="50%" valign="top">
<img src="https://raw.githubusercontent.com/dotimplement/HealthChain/main/docs/assets/images/hc-use-cases-clinical-integration.png" alt="Clinical Integration" width=100%>
<div align="center">
<br>
<a href="https://dotimplement.github.io/HealthChain/reference/gateway/cdshooks/"><strong>⚡️ Real-Time Clinical Workflow Integration</strong></a>
<br><br>
<div>Build CDS alerts and automated coding tools that integrate directly into Epic workflows</div><br>
<a href="https://dotimplement.github.io/HealthChain/cookbook/discharge_summarizer/">Getting Started →</a>
<br><br>
</div>
</td>
<td width="50%" valign="top">
<img src="https://raw.githubusercontent.com/dotimplement/HealthChain/main/docs/assets/images/openapi_docs.png" alt="FHIR Utilities" width=100%>
<div align="center">
<br>
<a href="https://dotimplement.github.io/HealthChain/reference/utilities/fhir_helpers/"><strong>🔥 FHIR Development Utilities</strong></a>
<br><br>
<div>Accelerate development with type-safe FHIR resource creation, validation helpers, and sandbox environments for testing clinical workflows</div><br>
<a href="https://dotimplement.github.io/HealthChain/reference/utilities/sandbox/">Getting Started →</a>
<br><br>
</div>
</td>
</tr>
</table>
### 🤖 For LLM / GenAI Developers
<table>
<tr>
<td width="50%" valign="top">
<img src="https://raw.githubusercontent.com/dotimplement/HealthChain/main/docs/assets/images/hc-use-cases-genai-aggregate.png" alt="Multi-Source Integration" width=100%>
<div align="center">
<br>
<a href="https://dotimplement.github.io/HealthChain/reference/gateway/gateway/"><strong>🔌 Multi-EHR Data Aggregation</strong></a>
<br><br>
<div>Aggregate patient data from multiple FHIR sources into unified records with built-in NLP processing and automatic deduplication</div><br>
<a href="https://dotimplement.github.io/HealthChain/cookbook/multi_ehr_aggregation/">Getting Started →</a>
<br><br>
</div>
</td>
<td width="50%" valign="top">
<img src="https://raw.githubusercontent.com/dotimplement/HealthChain/main/docs/assets/images/interopengine.png" alt="Format Conversion" width=100%>
<div align="center">
<br>
<a href="https://dotimplement.github.io/HealthChain/reference/interop/interop/"><strong>🔄 Healthcare Data Format Conversion</strong></a>
<br><br>
<div>Convert between FHIR and CDA formats with configuration-driven templates for unified data processing workflows</div><br>
<a href="https://dotimplement.github.io/HealthChain/cookbook/clinical_coding/">Getting Started →</a>
<br><br>
</div>
</td>
</tr>
</table>
### 🎓 For ML Researchers
<table>
<tr>
<td width="50%" valign="top">
<div align="center">
<img src="https://raw.githubusercontent.com/dotimplement/HealthChain/main/docs/assets/images/hc-use-cases-ml-deployment.png" alt="Deploy" width=60%>
</div>
<div align="center">
<br>
<a href="https://dotimplement.github.io/HealthChain/reference/gateway/fhir_gateway/"><strong>🚀 Deploy ML Models as Healthcare APIs</strong></a>
<br><br>
<div>Turn any trained model into a production-ready FHIR endpoint with OAuth2 authentication and type-safe healthcare data handling</div><br>
<a href="https://dotimplement.github.io/HealthChain/cookbook/ml_model_deployment/">Getting Started →</a>
<br><br>
</div>
</td>
</table>
## Why HealthChain?
**Electronic health record (EHR) data is specific, complex, and fragmented.** Most healthcare AI projects require months of manual integration and custom validation on top of model development. This leads to fragile pipelines that break easily and consume valuable developer time.
HealthChain understands healthcare protocols and data formats natively, so you don't have to build that knowledge from scratch. Skip months of custom integration work and productionize your healthcare AI faster.
- **Optimized for real-time** - Connect to live FHIR APIs and integration points instead of stale data exports
- **Automatic validation** - Type-safe FHIR models prevent broken healthcare data
- **Built-in NLP support** - Extract structured data from clinical notes, output as FHIR
- **Developer experience** - Modular and extensible architecture works across any EHR system
## Usage Examples
### Building a Pipeline [[Docs](https://dotimplement.github.io/HealthChain/reference/pipeline/pipeline)]
```python
from healthchain.pipeline import Pipeline
from healthchain.pipeline.components.integrations import SpacyNLP
from healthchain.io import Document
# Create medical NLP pipeline
nlp_pipeline = Pipeline[Document]()
nlp_pipeline.add_node(SpacyNLP.from_model_id("en_core_web_sm"))
nlp = nlp_pipeline.build()
doc = Document("Patient presents with hypertension and diabetes.")
result = nlp(doc)
spacy_doc = result.nlp.get_spacy_doc()
print(f"Entities: {[(ent.text, ent.label_) for ent in spacy_doc.ents]}")
print(f"FHIR conditions: {result.fhir.problem_list}") # Auto-converted to FHIR Bundle
```
### Creating a Gateway [[Docs](https://dotimplement.github.io/HealthChain/reference/gateway/gateway)]
```python
from healthchain.gateway import HealthChainAPI, FHIRGateway
from fhir.resources.patient import Patient
# Create healthcare application
app = HealthChainAPI(title="Multi-EHR Patient Data")
# Connect to multiple FHIR sources
fhir = FHIRGateway()
fhir.add_source("epic", "fhir://fhir.epic.com/r4?client_id=epic_client_id")
fhir.add_source("cerner", "fhir://fhir.cerner.com/r4?client_id=cerner_client_id")
@fhir.aggregate(Patient)
def enrich_patient_data(id: str, source: str) -> Patient:
"""Get patient data from any connected EHR and add AI enhancements"""
bundle = fhir.search(
Patient,
{"_id": id},
source,
add_provenance=True,
provenance_tag="ai-enhanced",
)
return bundle
app.register_gateway(fhir)
# Available at: GET /fhir/transform/Patient/123?source=epic
# Available at: GET /fhir/transform/Patient/123?source=cerner
if __name__ == "__main__":
import uvicorn
uvicorn.run(app, port=8000)
```
## Road Map
- [ ] 🔍 Data provenance and audit trails tracking
- [ ] 🔒 HIPAA compliance and security
- [ ] 🔄 HL7v2 parsing, FHIR profile conversion and OMOP mapping support
- [ ] 🚀 Enhanced deployment support with observability and telemetry (Docker, Kubernetes, etc.)
- [ ] 📊 Model performance monitoring with MLFlow integration
- [ ] 🤖 MCP server integration
## Contribute
We are always eager to hear feedback and suggestions, especially if you are a developer or researcher working with healthcare systems!
- 💡 Let's chat! [Discord](https://discord.gg/UQC6uAepUz)
- 🛠️ [Contribution Guidelines](CONTRIBUTING.md)
## Acknowledgements 🤗
This project builds on [fhir.resources](https://github.com/nazrulworld/fhir.resources) and [CDS Hooks](https://cds-hooks.org/) standards developed by [HL7](https://www.hl7.org/) and [Boston Children's Hospital](https://www.childrenshospital.org/).
<!-- Badge Links -->
[pypi-version-badge]: https://img.shields.io/pypi/v/healthchain?logo=python&logoColor=white&style=flat-square&color=%23e59875
[downloads-badge]: https://img.shields.io/pepy/dt/healthchain?style=flat-square&color=%2379a8a9
[stars-badge]: https://img.shields.io/github/stars/dotimplement/HealthChain?style=flat-square&logo=github&color=BD932F&logoColor=white
[license-badge]: https://img.shields.io/github/license/dotimplement/HealthChain?style=flat-square&color=%23e59875
[python-versions-badge]: https://img.shields.io/pypi/pyversions/healthchain?style=flat-square&color=%23eeeeee
[build-badge]: https://img.shields.io/github/actions/workflow/status/dotimplement/healthchain/ci.yml?branch=main&style=flat-square&color=%2379a8a9
[discord-badge]: https://img.shields.io/badge/chat-%235965f2?style=flat-square&logo=discord&logoColor=white
[substack-badge]: https://img.shields.io/badge/Cool_Things_In_HealthTech-%23c094ff?style=flat-square&logo=substack&logoColor=white
[pypi]: https://pypi.org/project/healthchain/
[pypistats]: https://pepy.tech/project/healthchain
[stars]: https://github.com/dotimplement/HealthChain/stargazers
[license]: https://github.com/dotimplement/HealthChain/blob/main/LICENSE
[build]: https://github.com/dotimplement/HealthChain/actions?query=branch%3Amain
[discord]: https://discord.gg/UQC6uAepUz
[substack]: https://jenniferjiangkells.substack.com/
Raw data
{
"_id": null,
"home_page": null,
"name": "healthchain",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.12,>=3.9",
"maintainer_email": null,
"keywords": "nlp, ai, llm, healthcare, ehr, mlops, fhir",
"author": "Jennifer Jiang-Kells",
"author_email": "jenniferjiangkells@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/0f/68/c386b3d4e1eec5d49faf78180368db1972382a0f4bc0ce805a2bd5396635/healthchain-0.10.1.tar.gz",
"platform": null,
"description": "<div align=\"center\" style=\"margin-bottom: 1em;\">\n\n# HealthChain \ud83d\udcab \ud83c\udfe5\n\n<img src=\"https://raw.githubusercontent.com/dotimplement/HealthChain/main/docs/assets/images/healthchain_logo.png\" alt=\"HealthChain Logo\" width=300></img>\n\n<!-- Project Badges -->\n[![PyPI Version][pypi-version-badge]][pypi]\n[![Stars][stars-badge]][stars]\n[![Downloads][downloads-badge]][pypistats]\n\n[![License][license-badge]][license]\n[![Python Versions][python-versions-badge]][pypi]\n[![Build Status][build-badge]][build]\n\n[![Substack][substack-badge]][substack]\n[![Discord][discord-badge]][discord]\n\n\n</div>\n\n<h2 align=\"center\" style=\"border-bottom: none\">Open-Source Framework for Productionizing Healthcare AI</h2>\n\n\n<div align=\"center\">\n\nHealthChain is an open-source developer framework to build healthcare AI applications with native protocol understanding. Skip months of custom integration with **built-in FHIR support**, **real-time EHR connectivity**, and **production-ready deployment** - all in Python.\n\n</div>\n\n## Installation\n\n```bash\npip install healthchain\n```\n\n## Core Features\n\nHealthChain is the **quickest way for AI/ML engineers to integrate their models with real healthcare systems**.\n\n\n### \ud83d\udca1 For HealthTech Engineers\n\n<table>\n <tr>\n <td width=\"50%\" valign=\"top\">\n <img src=\"https://raw.githubusercontent.com/dotimplement/HealthChain/main/docs/assets/images/hc-use-cases-clinical-integration.png\" alt=\"Clinical Integration\" width=100%>\n <div align=\"center\">\n <br>\n <a href=\"https://dotimplement.github.io/HealthChain/reference/gateway/cdshooks/\"><strong>\u26a1\ufe0f Real-Time Clinical Workflow Integration</strong></a>\n <br><br>\n <div>Build CDS alerts and automated coding tools that integrate directly into Epic workflows</div><br>\n <a href=\"https://dotimplement.github.io/HealthChain/cookbook/discharge_summarizer/\">Getting Started \u2192</a>\n <br><br>\n </div>\n </td>\n <td width=\"50%\" valign=\"top\">\n <img src=\"https://raw.githubusercontent.com/dotimplement/HealthChain/main/docs/assets/images/openapi_docs.png\" alt=\"FHIR Utilities\" width=100%>\n <div align=\"center\">\n <br>\n <a href=\"https://dotimplement.github.io/HealthChain/reference/utilities/fhir_helpers/\"><strong>\ud83d\udd25 FHIR Development Utilities</strong></a>\n <br><br>\n <div>Accelerate development with type-safe FHIR resource creation, validation helpers, and sandbox environments for testing clinical workflows</div><br>\n <a href=\"https://dotimplement.github.io/HealthChain/reference/utilities/sandbox/\">Getting Started \u2192</a>\n <br><br>\n </div>\n </td>\n </tr>\n</table>\n\n\n\n### \ud83e\udd16 For LLM / GenAI Developers\n\n<table>\n <tr>\n <td width=\"50%\" valign=\"top\">\n <img src=\"https://raw.githubusercontent.com/dotimplement/HealthChain/main/docs/assets/images/hc-use-cases-genai-aggregate.png\" alt=\"Multi-Source Integration\" width=100%>\n <div align=\"center\">\n <br>\n <a href=\"https://dotimplement.github.io/HealthChain/reference/gateway/gateway/\"><strong>\ud83d\udd0c Multi-EHR Data Aggregation</strong></a>\n <br><br>\n <div>Aggregate patient data from multiple FHIR sources into unified records with built-in NLP processing and automatic deduplication</div><br>\n <a href=\"https://dotimplement.github.io/HealthChain/cookbook/multi_ehr_aggregation/\">Getting Started \u2192</a>\n <br><br>\n </div>\n </td>\n <td width=\"50%\" valign=\"top\">\n <img src=\"https://raw.githubusercontent.com/dotimplement/HealthChain/main/docs/assets/images/interopengine.png\" alt=\"Format Conversion\" width=100%>\n <div align=\"center\">\n <br>\n <a href=\"https://dotimplement.github.io/HealthChain/reference/interop/interop/\"><strong>\ud83d\udd04 Healthcare Data Format Conversion</strong></a>\n <br><br>\n <div>Convert between FHIR and CDA formats with configuration-driven templates for unified data processing workflows</div><br>\n <a href=\"https://dotimplement.github.io/HealthChain/cookbook/clinical_coding/\">Getting Started \u2192</a>\n <br><br>\n </div>\n </td>\n </tr>\n</table>\n\n### \ud83c\udf93 For ML Researchers\n\n\n<table>\n <tr>\n <td width=\"50%\" valign=\"top\">\n <div align=\"center\">\n <img src=\"https://raw.githubusercontent.com/dotimplement/HealthChain/main/docs/assets/images/hc-use-cases-ml-deployment.png\" alt=\"Deploy\" width=60%>\n </div>\n <div align=\"center\">\n <br>\n <a href=\"https://dotimplement.github.io/HealthChain/reference/gateway/fhir_gateway/\"><strong>\ud83d\ude80 Deploy ML Models as Healthcare APIs</strong></a>\n <br><br>\n <div>Turn any trained model into a production-ready FHIR endpoint with OAuth2 authentication and type-safe healthcare data handling</div><br>\n <a href=\"https://dotimplement.github.io/HealthChain/cookbook/ml_model_deployment/\">Getting Started \u2192</a>\n <br><br>\n </div>\n </td>\n</table>\n\n\n## Why HealthChain?\n\n**Electronic health record (EHR) data is specific, complex, and fragmented.** Most healthcare AI projects require months of manual integration and custom validation on top of model development. This leads to fragile pipelines that break easily and consume valuable developer time.\n\nHealthChain understands healthcare protocols and data formats natively, so you don't have to build that knowledge from scratch. Skip months of custom integration work and productionize your healthcare AI faster.\n\n- **Optimized for real-time** - Connect to live FHIR APIs and integration points instead of stale data exports\n- **Automatic validation** - Type-safe FHIR models prevent broken healthcare data\n- **Built-in NLP support** - Extract structured data from clinical notes, output as FHIR\n- **Developer experience** - Modular and extensible architecture works across any EHR system\n\n## Usage Examples\n\n### Building a Pipeline [[Docs](https://dotimplement.github.io/HealthChain/reference/pipeline/pipeline)]\n\n```python\nfrom healthchain.pipeline import Pipeline\nfrom healthchain.pipeline.components.integrations import SpacyNLP\nfrom healthchain.io import Document\n\n# Create medical NLP pipeline\nnlp_pipeline = Pipeline[Document]()\nnlp_pipeline.add_node(SpacyNLP.from_model_id(\"en_core_web_sm\"))\n\nnlp = nlp_pipeline.build()\ndoc = Document(\"Patient presents with hypertension and diabetes.\")\nresult = nlp(doc)\n\nspacy_doc = result.nlp.get_spacy_doc()\nprint(f\"Entities: {[(ent.text, ent.label_) for ent in spacy_doc.ents]}\")\nprint(f\"FHIR conditions: {result.fhir.problem_list}\") # Auto-converted to FHIR Bundle\n```\n\n### Creating a Gateway [[Docs](https://dotimplement.github.io/HealthChain/reference/gateway/gateway)]\n\n```python\nfrom healthchain.gateway import HealthChainAPI, FHIRGateway\nfrom fhir.resources.patient import Patient\n\n# Create healthcare application\napp = HealthChainAPI(title=\"Multi-EHR Patient Data\")\n\n# Connect to multiple FHIR sources\nfhir = FHIRGateway()\nfhir.add_source(\"epic\", \"fhir://fhir.epic.com/r4?client_id=epic_client_id\")\nfhir.add_source(\"cerner\", \"fhir://fhir.cerner.com/r4?client_id=cerner_client_id\")\n\n@fhir.aggregate(Patient)\ndef enrich_patient_data(id: str, source: str) -> Patient:\n \"\"\"Get patient data from any connected EHR and add AI enhancements\"\"\"\n bundle = fhir.search(\n Patient,\n {\"_id\": id},\n source,\n add_provenance=True,\n provenance_tag=\"ai-enhanced\",\n )\n return bundle\n\napp.register_gateway(fhir)\n\n# Available at: GET /fhir/transform/Patient/123?source=epic\n# Available at: GET /fhir/transform/Patient/123?source=cerner\n\nif __name__ == \"__main__\":\n import uvicorn\n uvicorn.run(app, port=8000)\n```\n\n## Road Map\n\n- [ ] \ud83d\udd0d Data provenance and audit trails tracking\n- [ ] \ud83d\udd12 HIPAA compliance and security\n- [ ] \ud83d\udd04 HL7v2 parsing, FHIR profile conversion and OMOP mapping support\n- [ ] \ud83d\ude80 Enhanced deployment support with observability and telemetry (Docker, Kubernetes, etc.)\n- [ ] \ud83d\udcca Model performance monitoring with MLFlow integration\n- [ ] \ud83e\udd16 MCP server integration\n\n\n## Contribute\nWe are always eager to hear feedback and suggestions, especially if you are a developer or researcher working with healthcare systems!\n- \ud83d\udca1 Let's chat! [Discord](https://discord.gg/UQC6uAepUz)\n- \ud83d\udee0\ufe0f [Contribution Guidelines](CONTRIBUTING.md)\n\n\n## Acknowledgements \ud83e\udd17\nThis project builds on [fhir.resources](https://github.com/nazrulworld/fhir.resources) and [CDS Hooks](https://cds-hooks.org/) standards developed by [HL7](https://www.hl7.org/) and [Boston Children's Hospital](https://www.childrenshospital.org/).\n\n\n<!-- Badge Links -->\n[pypi-version-badge]: https://img.shields.io/pypi/v/healthchain?logo=python&logoColor=white&style=flat-square&color=%23e59875\n[downloads-badge]: https://img.shields.io/pepy/dt/healthchain?style=flat-square&color=%2379a8a9\n[stars-badge]: https://img.shields.io/github/stars/dotimplement/HealthChain?style=flat-square&logo=github&color=BD932F&logoColor=white\n[license-badge]: https://img.shields.io/github/license/dotimplement/HealthChain?style=flat-square&color=%23e59875\n[python-versions-badge]: https://img.shields.io/pypi/pyversions/healthchain?style=flat-square&color=%23eeeeee\n[build-badge]: https://img.shields.io/github/actions/workflow/status/dotimplement/healthchain/ci.yml?branch=main&style=flat-square&color=%2379a8a9\n[discord-badge]: https://img.shields.io/badge/chat-%235965f2?style=flat-square&logo=discord&logoColor=white\n[substack-badge]: https://img.shields.io/badge/Cool_Things_In_HealthTech-%23c094ff?style=flat-square&logo=substack&logoColor=white\n\n[pypi]: https://pypi.org/project/healthchain/\n[pypistats]: https://pepy.tech/project/healthchain\n[stars]: https://github.com/dotimplement/HealthChain/stargazers\n[license]: https://github.com/dotimplement/HealthChain/blob/main/LICENSE\n[build]: https://github.com/dotimplement/HealthChain/actions?query=branch%3Amain\n[discord]: https://discord.gg/UQC6uAepUz\n[substack]: https://jenniferjiangkells.substack.com/\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Open source framework for productionizing healthcare AI",
"version": "0.10.1",
"project_urls": {
"Documentation": "https://dotimplement.github.io/HealthChain/",
"Homepage": "https://dotimplement.github.io/HealthChain/",
"Repository": "https://github.com/dotimplement/HealthChain"
},
"split_keywords": [
"nlp",
" ai",
" llm",
" healthcare",
" ehr",
" mlops",
" fhir"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "4b7c53f8e8b91b2419e77fe87abc024ddbc9a481db62f93b7ed88c3c7e8dd636",
"md5": "ccce3a22a2d301a332c736f30e85e488",
"sha256": "944e74940137c293981f55933eb6ce448957cfbbd68e1d910c36e6cd93793df6"
},
"downloads": -1,
"filename": "healthchain-0.10.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ccce3a22a2d301a332c736f30e85e488",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.12,>=3.9",
"size": 222182,
"upload_time": "2025-10-14T14:19:47",
"upload_time_iso_8601": "2025-10-14T14:19:47.384186Z",
"url": "https://files.pythonhosted.org/packages/4b/7c/53f8e8b91b2419e77fe87abc024ddbc9a481db62f93b7ed88c3c7e8dd636/healthchain-0.10.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "0f68c386b3d4e1eec5d49faf78180368db1972382a0f4bc0ce805a2bd5396635",
"md5": "8801703d078d7d7b86e9e1c8f92e6199",
"sha256": "0056b17a65632c85323f677ee36559677fd726deccb92889241df854ab2b4222"
},
"downloads": -1,
"filename": "healthchain-0.10.1.tar.gz",
"has_sig": false,
"md5_digest": "8801703d078d7d7b86e9e1c8f92e6199",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.12,>=3.9",
"size": 157983,
"upload_time": "2025-10-14T14:19:48",
"upload_time_iso_8601": "2025-10-14T14:19:48.886887Z",
"url": "https://files.pythonhosted.org/packages/0f/68/c386b3d4e1eec5d49faf78180368db1972382a0f4bc0ce805a2bd5396635/healthchain-0.10.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-14 14:19:48",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "dotimplement",
"github_project": "HealthChain",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "healthchain"
}
JSON
