# Medical Health Record Summarizer [](LICENSE) [](https://www.python.org/downloads/) [](CONTRIBUTING.md) An Application for developing and testing medical health record summarization capabilities. This project aims to streamline healthcare documentation by automatically generating concise, accurate summaries of patient medical records. ## Project Overview This repository contains the development and testing framework for an app specifically designed to: - Parse complex medical health records - Extract key medical information - Generate comprehensive yet concise summaries - Maintain medical accuracy and terminology - Support healthcare professionals in documentation workflows ## Getting Started ### Prerequisites - Python 3.8 or higher - Node js Version 22 or higher and npm Version 10 or higher - Tesseract for OCR - pip package manager - Virtual environment (recommended) ### Installation 1. Clone the repository: \`\`\`bash git clone https://github.com/Usman-NisarUETTaxila/Medical-Health-Record-Summarizer.git cd Medical-Health-Record-Summarizer \`\`\` 2. Create and activate a virtual environment: \`\`\`bash python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate \`\`\` 3. Install required dependencies: \`\`\`bash pip install -r requirements.txt \`\`\` \`\`\`bash cd gradio/ui/clinic-intellect-main npm install \`\`\` ### Quick Start 1. Start the backend server \`\`\`bash cd patient_system python manage.py runserver \`\`\` 2. Start the Frontend app \`\`\`bash cd gradio/ui/clinic-intellect-main npm run dev \`\`\` ## Collaborators We thank the following contributors for their valuable contributions to this project: - **[Usman Nisar](https://github.com/Usman-NisarUETTaxila)** - *Project Lead* - University of Engineering and Technology, Taxila - **[Khawaja Muhammad Husnain](https://github.com/khhasnain05)** - *Backend Dev* - University of Engineering and Technology, Taxila - **[Hassaan Ayub](https://github.com/hassaan1821)** - *Frontend Dev* - University of Engineering and Technology, Taxila - **[Neha Qasim](https://github.com/Neha-Qasim)** - *Prompt Engineer* - University of Engineering and Technology, Taxila *To add yourself as a collaborator, please contribute to the project and your information will be added here.* ## License This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. ## Acknowledgement - Thanks to [Lovable](http://lovable.dev) and our Frontend Dev for powering the project with enhanced UI. - Thanks to [Windsurf](https://windsurf.com/editor) for Agentic AI Coding. ## Medical Disclaimer **Important**: This software is intended for research and development purposes. It should not be used as a substitute for professional medical advice, diagnosis, or treatment. Always consult with qualified healthcare professionals for medical decisions. ## Support - **Issues**: Please use the [GitHub Issues](https://github.com/Usman-NisarUETTaxila/Medical-Health-Record-Summarizer/issues) page for bug reports and feature requests - **Discussions**: Join our [GitHub Discussions](https://github.com/Usman-NisarUETTaxila/Medical-Health-Record-Summarizer/discussions) for general questions and community interaction - **Documentation**: Check the [docs/](docs/) directory for detailed documentation ## Related Projects - [Medical NLP Resources](https://github.com/topics/medical-nlp) - [Healthcare AI Tools](https://github.com/topics/healthcare-ai) - [Clinical Text Processing](https://github.com/topics/clinical-text-processing) ## Roadmap - [ ] Integration with major EHR systems - [ ] Multi-language support for medical records - [ ] Real-time summarization capabilities - [ ] Advanced visualization of medical insights - [ ] Mobile application development - [ ] FHIR standard compliance **Made with ️ for the healthcare community** *Last updated: September 2025*