AI-MOA (AI-powered Medical Office Assistant)

Copyright © 2024 by Spring Health Corporation, Toronto, Ontario, Canada
LICENSE: GNU Affero General Public License Version 3
Document Version 2025.03.07

AI-MOA is an advanced, AI-powered Medical Office Assistant designed to automate various tasks in a medical office setting. It focuses on document processing, workflow management, and seamless integration with the O19 Electronic Medical Record (EMR) system.

Features

• Automated document processing and classification using AI
• Advanced PDF processing with OCR capabilities
• Intelligent workflow management system
• Seamless integration with O19 EMR system
• Automated login and session management
• Highly configurable settings and workflows
• Comprehensive provider list management
• Robust error handling and detailed logging
• Docker support for easy deployment and scaling
• Task queue management with Huey (in-memory storage)

Project Structure

ai-moa/
├── src/
│   ├── ai_moa_utils/
│   │   ├── __init__.py
│   │   └── logging_setup.py
│   ├── auth/
│   │   ├── __init__.py
│   │   ├── driver_manager.py
│   │   ├── login_manager.py
│   │   └── session_manager.py
│   ├── config/
│   │   ├── __init__.py
│   │   ├── config_manager.py
│   │   └── provider_list_manager.py
│   ├── processors/
│   │   ├── __init__.py
│   │   ├── document_tagger/
│   │   │   ├── __init__.py
│   │   │   └── document_category.py
│   │   ├── o19/
│   │   │   ├── __init__.py
│   │   │   ├── o19_inbox.py
│   │   │   └── o19_updater.py
│   │   ├── patient_tagger/
│   │   │   ├── __init__.py
│   │   │   └── patient.py
│   │   ├── provider_tagger/
│   │   │   ├── __init__.py
│   │   │   └── provider.py
│   │   ├── utils/
│   │   │   ├── __init__.py
│   │   │   ├── llm.py
│   │   │   ├── local_files.py
│   │   │   └── ocr.py
│   │   └── workflow/
│   │       ├── __init__.py
│   │       └── emr_workflow.py
│   ├── config.yaml
│   ├── main.py
│   ├── requirements.txt
│   └── workflow-config.yaml
├── docker-compose.yaml
├── Dockerfile
├── LICENSE
└── README.md

Setup and Installation

For Linux installation, please refer to the install/Readme.md for a Complete Packaged Installation of Aimee AI.

For Windows installation, please refer to the windows/Readme.md for guidance.

The following is a brief example of the installation steps:

1. Clone the repository:

   git clone https://github.com/GetWellClinic/ai-moa.git
   cd ai-moa
   

2. Create config, logs, and static directories:

   mkdir -p logs config src/static
   

3. Create and activate a virtual environment:

   python -m venv .env
   source .env/bin/activate  # On Windows, use `.env\Scripts\activate`
   

4. Install dependencies:

   Install python dependencies inside python virtual environment:

   pip install -r src/requirements.txt
   

   Install google-chrome

   wget -q -O - https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo apt-key add -
   echo "deb http://dl.google.com/linux/chrome/deb/ stable main" >> /etc/apt/sources.list.d/google.list
   apt-get update
   apt-get install google-chrome-stable
   

5. Configure the application:

   Install the config files by copying the src/ * .yaml.examples config files to directory config/ * .yaml

   cp src/config.yaml.example config/config.yaml
   cp src/workflow-config.yaml.example config/workflow-config.yaml
   cp src/template_providerlist.txt config/
   

   Set the permissions on directory and files:

   chmod ug+rwx config logs
   chmod ug+rw config/* logs/*
   chmod o-rwx config
   

   A. Edit config/config.yaml and customize the application settings. (Mandatory)

   B. Edit the config/workflow-config.yaml to customize the workflow. (Default will work)

6. Run the AI-MOA application:

   cd src/
   python main.py
   

   NOTE: In order for AI-MOA to function properly, you must also have configured AI-MOA to access an LLM endpoint. For your convenience, we have included a standard "llm-container" docker image that you can easily setup and run a local LLM. Remember to download an appropriate LLM model GGUF file to "llm-container/models/".

   You can use some parameter flags to customize the startup: (ie.)

   python main.py
   --config ../config/config.yaml
   --workflow-config ../config/workflow-config.yaml
   --run-immediately
   --cron-interval */5
   

Contributing

Contributions to AI-MOA are welcome. Please follow these steps:

1. Fork the repository
2. Create a new branch (git checkout -b feature/your-feature-name)
3. Make your changes
4. Run the tests to ensure everything is working
5. Commit your changes (git commit -am 'Add some feature')
6. Push to the branch (git push origin feature/your-feature-name)
7. Create a new Pull Request

Please read CONTRIBUTING.md for more details on our code of conduct and development process.

For Developers

See the DEVELOPERS.md file for details.

License

This project is licensed under the GNU Affero General Public License v3.0. See the LICENSE file for details.

Support

For questions, bug reports, or feature requests, please open an issue on the GitHub repository.