Skip to content

gowthamvsn/clinical-assistant-chatbot

Repository files navigation

Clinical Assistant Chatbot

A clinical-domain conversational assistant built using natural language processing techniques and real-world medical text data.
This project focuses on symptom understanding and medical information support, not diagnosis or treatment.


📌 Motivation

Most healthcare chatbots either:

  • Use black-box language models with no transparency, or
  • Provide unsafe diagnostic-style responses.

This project aims to bridge that gap by:

  • Using real clinical text samples
  • Applying interpretable NLP techniques
  • Enforcing safety-aware response logic
  • Clearly separating information support from medical advice

⚠️ Important Disclaimer

This chatbot is not a medical professional and does not provide diagnosis, treatment, or medical advice.
It is intended only for educational and informational purposes.

Users are always advised to consult licensed healthcare professionals for medical decisions.


🧠 How It Works

  1. Clinical Dataset

    • Uses the mtsamples.csv dataset containing anonymized medical transcription samples.
    • Covers clinical notes, symptoms, procedures, and diagnoses (as text only).
  2. Text Processing

    • Cleans and normalizes clinical language.
    • Extracts meaningful context from user queries.
  3. Response Logic

    • Matches user input against relevant clinical text patterns.
    • Generates context-aware informational responses.
    • Applies safeguards to avoid diagnosis-like output.
  4. Application Layer

    • Implemented in Python (medical_chatbot_main_application.py)
    • Can be deployed using the included Procfile.

Use Cases

Clinical NLP experimentation

Healthcare AI research demos

Educational medical chat interfaces

Portfolio project for AI/ML roles

📂 Project Structure

clinical-assistant-chatbot/
├── medical_chatbot_main_application.py # Main chatbot logic
├── mtsamples.csv # Clinical text dataset
├── requirements.txt # Python dependencies
├── Procfile # Deployment configuration
├── chatbot_logo_1.png # Branding
└── README.md

🚀 How to Run Locally

# 1. Create environment
python -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate

# 2. Install dependencies
pip install -r requirements.txt

# 3. Run the chatbot
python medical_chatbot_main_application.py

Future Improvements

Add transformer-based embeddings (e.g., Sentence-BERT) Implement retrieval-augmented generation (RAG) Add confidence scoring for responses Improve safety filtering and disclaimers Web UI (Streamlit / Flask)

About

Clinical-domain chatbot for symptom understanding and medical information support using NLP and real clinical text data.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors