MedPractice Reception Agent

Overview

The MedPractice Reception Agent is an AI-powered reception system for medical practices, built on Flowbite, HUGO, Tailwind CSS and the OpenAI Realtime API. This application provides an intelligent interface for patient registration using Self-Sovereign Identity (SSI) technology.

The Reception Agent enables patients to share their health information securely with medical practices through the following workflow:

1. An AI assistant engages with the patient to guide them through the registration process
2. The system generates an OpenID4VP (OpenID for Verifiable Presentations) request
3. This request is rendered as a QR code on the reception interface
4. Patients scan the QR code with their HealthWallet-IPS mobile application
5. Patients select which health information they want to share with the practice
6. The shared information is securely transmitted and displayed in the reception interface

Key Features

• AI-Powered Reception Assistant: Uses OpenAI's real-time API for natural language interaction with patients
• Secure Health Information Sharing: Implements OpenID4VP for verifiable credential presentation
• QR Code Generation: Creates QR codes to facilitate mobile wallet interaction
• Comprehensive Health Information Display: Presents patient information in an organized, readable format
• Real-Time Event Logging: Tracks all system events during patient interaction

Technologies Used

• Frontend Framework: Flowbite components with Tailwind CSS
• Static Site Generator: HUGO
• JavaScript Libraries:
  • Valtio for state management
• Backend Integration:
  • OpenAI Realtime API for conversational AI
• Health SSI PIS Server: Practice Information System (PIS) backend server with API's for SSI and patient/medication mgmt

Prerequisites

• Node.js (v14 or higher)
• npm (v7 or higher)
• OpenAI API key

Setup and Installation

1. Clone the repository:

   git clone https://github.com/deak-ai/healthssi-medpractice.git
   cd healthssi-medpractice

2. Install dependencies:

   npm install

3. Create a .env file in the root directory with your OpenAI API key:

   OPENAI_API_KEY=your_openai_api_key_here
   

4. Start the development server:

   npm run start

5. Access the application in your browser at http://localhost:1313

Usage

1. Navigate to the Reception page in the application
2. Click the "Start Session" button to activate the AI assistant
3. Interact with the assistant to begin the registration process
4. When prompted, a QR code will be displayed on the screen
5. Scan the QR code with the HealthWallet-IPS mobile application
6. Select which health information to share with the practice
7. View the shared health information displayed in the interface

Related Projects

• Health SSI V2: Umbrella project linking to several Digital Health with Self-Sovereign Identity (SSI) initiatives
• HealthWallet IPS: Mobile wallet application for managing and sharing health information
• Health SSI PIS Server: Practice Information System (PIS) backend server with API's for SSI and patient/medication mgmt

License

MIT License