OpenMRS Smart IA

Artificial Intelligence for your OpenMRS (Open Medical Record System)

Overview • Features • How It Works • Getting Started • Usage • Contributing • License • Contact

Overview

OpenMRS Smart IA is an innovative Flask-based project that integrates OpenMRS (Open Medical Record System) with OpenAI to provide intelligent responses to medical-related questions based on OpenMRS data.

This project creates a bridge between OpenMRS, a widely used open-source medical record system, and OpenAI's powerful language models. By leveraging the vast amount of medical data stored in OpenMRS and the natural language processing capabilities of OpenAI, OpenMRS Smart IA enables users to ask medical-related questions and receive informed answers based on real patient data.

Features

• 🔗 Seamless integration with OpenMRS for accessing medical record data
• 🧠 Utilization of OpenAI's language models for natural language processing
• 🖥️ User-friendly interface for asking medical-related questions
• 📊 Data-driven responses based on OpenMRS information
• 🌐 RESTful API for easy integration with other healthcare systems

How It Works

1. Users input medical-related questions through the application interface.
2. The system processes the questions using OpenAI's language models.
3. Relevant data is retrieved from the OpenMRS database.
4. The AI generates informative responses based on the OpenMRS data and the user's query.
5. The answer is presented to the user in a clear and understandable format.

Getting Started

Prerequisites

• Python 3.8+
• Flask
• OpenMRS instance
• OpenAI API key

Installation

1. Clone the repository:

   git clone https://github.com/eltonlaice/openmrs-smart-ia.git
   cd openmrs-smart-ia

2. Install required packages:

   pip install -r requirements.txt

3. Set up environment variables:

   cp .env.example .env

   Edit the .env file with your OpenMRS and OpenAI credentials.

4. Run the application:

   flask run

Usage

To use the OpenMRS Smart IA API, you can send a POST request to the /api/query endpoint with your medical-related question. Here's an example using Python:

import requests

url = "http://localhost:5000/api/query"
payload = {"question": "What is the average blood pressure of patients with diabetes?"}
response = requests.post(url, json=payload)

print(response.json())

The API will process your question, retrieve relevant data from OpenMRS, and return an AI-generated response based on the available information.

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Elton Laice - @eltonlaice - meu@eltonlaice.com

Project Link: https://github.com/eltonlaice/openmrs-smart-ia

---

Developed with ❤️ by Elton Laice