Update README.md
Browse files
README.md
CHANGED
@@ -21,48 +21,55 @@ tags:
|
|
21 |
- demo-only
|
22 |
- hackathon-submission
|
23 |
---
|
24 |
-
|
25 |
-
|
26 |
-
|
27 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
28 |
> **β οΈ IMPORTANT DISCLAIMER - DEMO/MVP ONLY**
|
|
|
29 |
> This is a **technology demonstration and MVP prototype** for development, testing, and educational purposes only.
|
30 |
-
> **NOT approved for clinical use, patient data, or production healthcare environments.**
|
31 |
-
> Requires proper regulatory evaluation, compliance review, and legal assessment before any real-world deployment.
|
32 |
-
|
33 |
-
**Dockerized Healthcare AI Platform: Local/Cloud/Hybrid Deployment + Agent/MCP Server + FHIR R4/R5 + DICOM Processing + CodeLlama Integration**
|
34 |
-
|
35 |
-
*This prototype demonstrates enterprise-grade medical AI architecture patterns, FHIR compliance workflows, and agent-to-agent communication for healthcare data intelligence - designed for technology evaluation and development purposes.*
|
36 |
|
37 |
[](https://huggingface.co/spaces/grasant/fhirflame)
|
38 |
-
[](#)
|
40 |
|
41 |
---
|
42 |
-
[](#)
|
43 |
-
|
44 |
|
45 |
-
|
|
|
46 |
|
47 |
-
|
48 |
-
|
49 |
-
## π
Gradio Hackathon Competition Categories
|
50 |
|
51 |
-
|
52 |
-
- **Official MCP Server** with 2 specialized healthcare tools
|
53 |
-
- **Real-time Claude/GPT integration** for medical document processing
|
54 |
-
- **Agent-to-agent workflows** for complex medical scenarios
|
55 |
|
56 |
-
###
|
57 |
- **Multi-provider AI routing** (Ollama β Modal L4 β HuggingFace β Mistral)
|
58 |
- **FHIR R4/R5 compliance engine** with 100% validation score and zero-dummy-data policy
|
59 |
- **Real-time batch processing demo** with live dashboard integration
|
60 |
-
- **Heavy workload demonstration** with 6-container orchestration
|
|
|
|
|
|
|
|
|
|
|
|
|
61 |
|
62 |
-
###
|
63 |
-
- **
|
64 |
-
- **
|
65 |
-
- **
|
|
|
66 |
|
67 |
---
|
68 |
|
@@ -88,9 +95,9 @@ LANGFUSE_PUBLIC_KEY=your-langfuse-public
|
|
88 |
|
89 |
### **π― Intelligent Provider Routing**
|
90 |
- **Ollama Local**: Development and sensitive data ($0.00/request)
|
91 |
-
- **Modal L4 GPU**: Production scaling
|
92 |
-
- **HuggingFace**: Specialized medical models and fallback for ollama
|
93 |
-
- **Mistral Vision**: OCR and document understanding
|
94 |
---
|
95 |
|
96 |
## π Quick Start & Live Demo
|
@@ -114,6 +121,12 @@ open http://localhost:3000 # Langfuse Monitoring
|
|
114 |
open http://localhost:8000 # A2A API
|
115 |
```
|
116 |
|
|
|
|
|
|
|
|
|
|
|
|
|
117 |
---
|
118 |
|
119 |
## π MCP Protocol Excellence
|
@@ -395,60 +408,10 @@ docker-compose -f docker-compose.modal.yml up -d
|
|
395 |
- **R4 Bundle Generation**: 100% compliance
|
396 |
- **R5 Bundle Generation**: 100% compliance
|
397 |
- **Validation Speed**: <200ms per bundle
|
398 |
-
- **Error Detection**:
|
399 |
-
|
400 |
-
---
|
401 |
-
|
402 |
-
## π οΈ Technology Stack
|
403 |
-
|
404 |
-
### **Core Framework**
|
405 |
-
- **Backend**: Python 3.11, FastAPI, Asyncio
|
406 |
-
- **Frontend**: Gradio with custom FhirFlame branding
|
407 |
-
- **AI Models**: CodeLlama 13B, Modal L4 GPUs, HuggingFace
|
408 |
-
- **Healthcare**: FHIR R4/R5, DICOM file processing, HL7 standards
|
409 |
-
|
410 |
-
### **Infrastructure**
|
411 |
-
- **Deployment**: Docker Compose, HF Spaces, Modal Labs
|
412 |
-
- **Monitoring**: Langfuse integration, real-time analytics
|
413 |
-
- **Database**: PostgreSQL, ClickHouse for analytics
|
414 |
-
- **Security**: HIPAA considerations, audit logging
|
415 |
|
416 |
---
|
417 |
|
418 |
-
## π Security & Compliance
|
419 |
-
|
420 |
-
### **Healthcare Standards**
|
421 |
-
- **FHIR R4/R5**: Full compliance with HL7 standards
|
422 |
-
- **HIPAA Considerations**: Built-in audit logging
|
423 |
-
- **Zero-Dummy-Data**: Production-safe entity extraction
|
424 |
-
- **Data Privacy**: Local processing options available
|
425 |
-
|
426 |
-
### **Security Features**
|
427 |
-
- **JWT Authentication**: Secure API access
|
428 |
-
- **Audit Trails**: Complete interaction logging
|
429 |
-
- **Container Isolation**: Docker security boundaries
|
430 |
-
- **Environment Secrets**: Secure configuration management
|
431 |
-
|
432 |
-
---
|
433 |
-
|
434 |
-
## π€ Contributing & Development
|
435 |
-
|
436 |
-
### **Development Setup**
|
437 |
-
```bash
|
438 |
-
# Fork and clone
|
439 |
-
git clone https://github.com/your-username/fhirflame.git
|
440 |
-
cd fhirflame
|
441 |
-
|
442 |
-
# Install dependencies
|
443 |
-
pip install -r requirements.txt
|
444 |
-
|
445 |
-
# Run tests
|
446 |
-
python -m pytest tests/ -v
|
447 |
-
|
448 |
-
# Start development server
|
449 |
-
python app.py
|
450 |
-
```
|
451 |
-
|
452 |
### **Code Structure**
|
453 |
```
|
454 |
fhirflame/
|
@@ -463,27 +426,8 @@ fhirflame/
|
|
463 |
```
|
464 |
|
465 |
---
|
466 |
-
|
467 |
## π License & Credits
|
468 |
|
469 |
**Apache License 2.0** - Open source healthcare AI platform
|
470 |
|
471 |
-
|
472 |
-
- **FhirFlame Development Team** - Medical AI specialists
|
473 |
-
- **Healthcare Compliance** - Built with medical professionals
|
474 |
-
- **Open Source Community** - FHIR, MCP, and healthcare standards
|
475 |
-
|
476 |
-
### **Healthcare Standards Compliance**
|
477 |
-
- **HL7 FHIR** - Official healthcare interoperability standards
|
478 |
-
- **Model Context Protocol** - Agent communication standards
|
479 |
-
- **Medical AI Ethics** - Responsible healthcare AI development
|
480 |
-
|
481 |
-
---
|
482 |
-
|
483 |
-
**π₯ Built for healthcare professionals by healthcare AI specialists**
|
484 |
-
**β‘ Powered by Modal Labs L4 GPU infrastructure**
|
485 |
-
**π Trusted for healthcare compliance and data security**
|
486 |
-
|
487 |
-
---
|
488 |
-
|
489 |
-
*Last Updated: June 2025 | Version: Hackathon Submission*
|
|
|
21 |
- demo-only
|
22 |
- hackathon-submission
|
23 |
---
|
24 |
+
# π₯π₯ FhirFlame: Medical AI Data Processing Tool
|
25 |
+
|
26 |
+
#### *This prototype demonstrates enterprise-grade medical AI architecture patterns, FHIR compliance workflows, and agent-to-agent communication for healthcare data intelligence - designed for technology evaluation and development purposes.*
|
27 |
+
|
28 |
+
+ Dockerized modular Healthcare AI Platform
|
29 |
+
+ Local/Cloud/Hybrid System Deployment depending on needs and available hardware (Optimized for local use on 4090 or on Huggingface Space Nvidia L4 or on Modal Labs, to ulock dynamically scaling infrastructure)
|
30 |
+
+ A2A/MCP Server json comunication via FastAPI (Auth0 ready)
|
31 |
+
+ TDD with integrated set of tests to keep HL7 standards (FHIR R4/R5 compliant outpout)
|
32 |
+
+ NLP data extraction tested on real validation data (text -> formatted JSON)
|
33 |
+
+ Optional Mistral OCR
|
34 |
+
+ DICOM files Processing
|
35 |
+
+ Local first design: tested with CodeLlama13b (Nvidia L4/4090 optimzed) or any model from HuggingFace HUB
|
36 |
+
+ PostgreSQL-First Design with In-Memory Compatibility and Job Management
|
37 |
+
+ Gradio frontend for smootoh UI experience
|
38 |
+
+ Langfuse for better logging and system health tracking
|
39 |
+
---
|
40 |
> **β οΈ IMPORTANT DISCLAIMER - DEMO/MVP ONLY**
|
41 |
+
>
|
42 |
> This is a **technology demonstration and MVP prototype** for development, testing, and educational purposes only.
|
|
|
|
|
|
|
|
|
|
|
|
|
43 |
|
44 |
[](https://huggingface.co/spaces/grasant/fhirflame)
|
45 |
+
[](https://leksval.github.io/fhirflame/index.html)
|
|
|
46 |
|
47 |
---
|
|
|
|
|
48 |
|
49 |
+
### **Project Demo**
|
50 |
+
https://github.com/user-attachments/assets/83947dfe-0c7b-4401-8f58-e0ce8d04b858
|
51 |
|
52 |
+
---
|
|
|
|
|
53 |
|
54 |
+
## π Security & Compliance
|
|
|
|
|
|
|
55 |
|
56 |
+
### **π₯ Innovative Healthcare Application**
|
57 |
- **Multi-provider AI routing** (Ollama β Modal L4 β HuggingFace β Mistral)
|
58 |
- **FHIR R4/R5 compliance engine** with 100% validation score and zero-dummy-data policy
|
59 |
- **Real-time batch processing demo** with live dashboard integration
|
60 |
+
- **Heavy workload demonstration** with 6-container orchestration and auto-scaling based on worklad requirements
|
61 |
+
-
|
62 |
+
### **Healthcare Standards**
|
63 |
+
- **HL7 standards**: Fully FHIR R4/R5 compliant
|
64 |
+
- **HIPAA Considerations**: Built-in audit logging
|
65 |
+
- **Zero-Dummy-Data**: Production-safe entity extraction
|
66 |
+
- **Medical AI Ethics** - Responsible healthcare AI development: local & open soursce first
|
67 |
|
68 |
+
### **Security Features**
|
69 |
+
- **JWT Authentication**: Secure API access
|
70 |
+
- **Audit Trails**: Complete interaction logging
|
71 |
+
- **Container Isolation**: Docker security boundaries
|
72 |
+
- **Environment Secrets**: Secure configuration management
|
73 |
|
74 |
---
|
75 |
|
|
|
95 |
|
96 |
### **π― Intelligent Provider Routing**
|
97 |
- **Ollama Local**: Development and sensitive data ($0.00/request)
|
98 |
+
- **Modal Labs, desighned for L4 GPU**: Production dynamic scaling based on workload
|
99 |
+
- **HuggingFace API**: Specialized medical models and fallback for ollama
|
100 |
+
- **Mistral Vision API**: OCR and document understanding
|
101 |
---
|
102 |
|
103 |
## π Quick Start & Live Demo
|
|
|
121 |
open http://localhost:8000 # A2A API
|
122 |
```
|
123 |
|
124 |
+
### **π Communication System**
|
125 |
+
- **Official MCP Server** with 2 specialized healthcare tools
|
126 |
+
- **Real-time Claude/GPT integration** for medical document processing
|
127 |
+
- **A2A API endpoints** for healthcare system integration
|
128 |
+
- **Production-ready architecture** for hospital environments
|
129 |
+
- **Standardized JSON output** for complex medical scenarios
|
130 |
---
|
131 |
|
132 |
## π MCP Protocol Excellence
|
|
|
408 |
- **R4 Bundle Generation**: 100% compliance
|
409 |
- **R5 Bundle Generation**: 100% compliance
|
410 |
- **Validation Speed**: <200ms per bundle
|
411 |
+
- **Error Detection**: robust issue identification
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
412 |
|
413 |
---
|
414 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
415 |
### **Code Structure**
|
416 |
```
|
417 |
fhirflame/
|
|
|
426 |
```
|
427 |
|
428 |
---
|
|
|
429 |
## π License & Credits
|
430 |
|
431 |
**Apache License 2.0** - Open source healthcare AI platform
|
432 |
|
433 |
+
*Last Updated: June 2025 | Version: Hackathon Submission*
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|