first commit

README.md

@@ -0,0 +1,69 @@
+# MediChaiD: AI-Based Conversational Assistance for Chronic Disease Management
+
+**ChaD GPT: A GPT for Conversational Health Assistance & Direction**
+
+<div align="center">
+    <img src="imgs/ChaDoctor.png" alt="MediChaid Logo" width="200" style="border-radius: 50%;"/>
+</div>
+
+**MediChaiD** is a conversational platform built on CHAD (Coordinated Heuristics Across Domains), a network of specialized AI agents designed to provide informational support, guidance, and continuous assistance along the healthcare journey. These agents do not deliver diagnoses instead, they help users understand their symptoms, ask the right questions, stay informed over time, and when needed, connect directly with qualified healthcare professionals.
+
+**Demo:** [https://crohnai-app.kube-ext.isc.heia-fr.ch/](https://crohnai-app.kube-ext.isc.heia-fr.ch/)
+
+---
+
+**Author: Ing. Rossi Stefano**:
+- B.Sc. in Applied Computer Science - Data Engineering
+- Specialized in AI and Software Engineering
+- Website: [www.rossistefano.ch](https://www.rossistefano.ch)
+- Email: [dev@rossistefano.ch](mailto:dev@rossistefano.ch)
+
+**Project Information**:
+- Project: **ChaD - Conversational Health Assistance & Direction**
+- WhatsApp: [ChaD AI Community](https://chat.whatsapp.com/ChadAI)
+- Module Name: **MediChaid**
+- Repository: [GitLab - MediChaiD](git@gitlab.com:stefanorossiti/medichaid-ai-assistant-for-crohns-disease.git)
+- Published: **2025-05-06**
+- Latest update: **2025-05-06**
+- Version: **Alfa1**
+- License: **Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)**
+
+---
+
+## Description
+
+**MediChaid** is an AI-based personal assistant designed to support and advise individuals diagnosed with Crohn's disease throughout the various stages of their condition. This project is a prototype aimed at exploring the potential applications of artificial intelligence within this specific area of healthcare.
+
+The project is accompanied by a (non peer-reviewed) paper: [MediChaiD an AI-Based Conversational Assistance for Chronic Disease Management](MediChaiD%20an%20AI-Based%20Conversational%20Assistance%20for%20Chronic%20Disease%20Management.md) that provides a comprehensive overview of the design and development process, as well as the challenges and opportunities encountered along the way.
+
+## Introduction
+
+This Alpha implementation is intended to provide informative support and personalized recommendations by leveraging large language models (LLMs) to interact with the user. The alpha provided here is a prototype that serves as a proof of concept for the potential of AI in healthcare, specifically for patients with Crohn's disease.
+
+### Research Paper
+
+This project is supported by a personal (non-peer-reviewed) research paper, which delves deeper into the topic, exploring the challenges and opportunities of developing an AI assistant for Crohn's disease patients. The paper provides broader context and discusses the design decisions made during the prototyping phase.
+
+During the development of this project, I have also gather feedback from user testers, which has been invaluable source of information for future refining of s features and functionality. The feedback have been documented and discussed in the research paper.
+
+## Local Setup
+
+To run MediChaiD locally using the provided Docker Compose configuration.
+
+## Docker Compose Architecture
+
+```mermaid
+graph TD
+    mariadb[MariaDB]
+    phpmyadmin[PhpMyAdmin]
+    qdrant[Qdrant]
+    ollama[Ollama]
+    rag_service[RAG Service]
+    real_time_chat_app[Real-Time Chat App]
+
+    phpmyadmin --> mariadb
+    rag_service --> qdrant
+    rag_service --> mariadb
+    rag_service --> ollama
+    real_time_chat_app --> rag_service
+```