File size: 1,926 Bytes
660961e afe6bd0 660961e afe6bd0 660961e | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 | # CHFReportGenerator 🫀
An evidence-anchored, research-focused system for automated Congestive Heart Failure (CHF) analysis that provides diagnostic decision support, clinically grounded report generation, and explainable evidence highlighting supporting regions.
---
## 🔖 Project at a Glance
- **Project name:** CHFReportGenerator
- **Primary goal:** Generate clinically grounded and explainable CHF reports
- **Focus:** Interpretability, transparency, and reproducibility
- **Intended users:** Researchers, PhD evaluators, clinicians (research support)
---
## ✨ Key Features & Contributions
- **Evidence-anchored reporting**
Every generated finding is explicitly linked to supporting evidence.
- **Clinically grounded narratives**
Outputs are written in structured, clinically meaningful language.
- **Parameter-efficient fine-tuning (QLoRA)**
Adapts a large language model with minimal computational cost.
- **Research-first design**
Built to support academic evaluation and reproducibility.
- **Hardware-efficient**
4-bit quantization enables large-model usage on limited GPU resources.
---
## 🧠 Model Overview
- **Base model:** Qwen2.5-VL-7B-Instruct
- **Model type:** Vision-Language Large Language Model
- **Quantization:** 4-bit (BitsAndBytes)
- **Framework:** Unsloth
- **Maximum sequence length:** 2048 tokens
- **Fine-Tuning Method:** QLoRA
The base model provides general reasoning and language understanding,
while CHF-specific behavior is introduced through lightweight adapters.
---
## ⚙️ Installation
### Requirements
- Python 3.8 or higher
- CUDA-enabled GPU (recommended)
- PyTorch
- Hugging Face Transformers
- Unsloth
- BitsAndBytes
All dependencies are listed in `requirements.txt`.
### Step-by-Step Setup
```bash
git clone https://huggingface.co/aiyubali/CHFReportGenerator
cd CHFReportGenerator
pip install -r requirements.txt
|