Skip to content

raghdaneiazyy6/MORDENT.AI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🦷 MORDENT.AI – DICOM Viewer Platform with AI-Powered Cephalometric Analysis

MORDENT.AI where orthodontic diagnostics gets a modern twist! This web platform is designed to streamline clinical workflows with a killer combo of AI-driven cephalometric analysis and a top-tier DICOM viewer powered by Cornerstone3D. Dive into crisp, interactive dental imaging with a slick interface that makes navigation a breeze. Secure image management and seamless integration with Orthanc PACS Server ensure your data is always at your fingertips, ready for precision diagnostics!

"Precision Meets Efficiency in Orthodontic Diagnostics"

🚀 Core Features

  • 🧠 Advanced AI Analysis: Utilizes a dual-stage YOLOv11 and Graph Neural Network engine for highly accurate automated cephalometric landmark detection.
  • 🔒 Secure DICOM Integration: Built on the Orthanc DICOM server for robust and secure medical image management and retrieval.
  • 🔄 Real-Time Clinical Validation: Features an interactive DICOM viewer that allows clinicians to instantly review, adjust, and validate DICOM studies.
  • 🤝 Seamless Workflow Fit: Designed for effortless integration into existing clinical environments with real-time data synchronization.

📋 Prerequisites

Before you begin, ensure you have the following installed on your system:

System Requirements

DICOM Server Requirements

  • Orthanc DICOM Server - Download here
    • Install the appropriate version for your operating system.

🚀 Installation & Running

Follow these steps in order to get MORDENT.AI running on your local machine.

1. Clone the Repository

git clone https://github.com/yourusername/mordent-ai.git
cd mordent-ai

2. Install Orthanc DICOM Server

Install Orthanc on your system. This is a one-time setup.

  • For Windows: Download and run the installer from the official website.
  • For macOS: Use Homebrew:
brew install orthanc
  • For Linux (Ubuntu/Debian):
sudo apt-get update && sudo apt-get install orthanc orthanc-dicomweb

3. Set Up and Run the Backend

In a terminal, navigate to the backend directory, install dependencies, and start the servers.

A. Start the Orthanc DICOM Server: The provided script will start your local Orthanc instance.

# Navigate to the script's location from the project root
cd backend/orthanc/config/scripts

# Make the script executable
chmod +x starter_script.sh

# Run the script
./starter_script.sh

📝 Note: The script will try to find your Orthanc installation. If it fails, you'll be prompted to provide the path manually. Once it's running, leave this terminal open.

B. Start the MORDENT.AI Backend: Open a new terminal. From the project root (mordent-ai/), run the following:

# Navigate to the backend directory
cd backend

# Install dependencies
npm install --legacy-peer-deps

# Start the server
npm start

The backend server will now be running on http://localhost:3000. Keep this terminal open.

4. Set Up and Run the Frontend

Open a third terminal. From the project root (mordent-ai/), run the following:

# Navigate to the frontend directory
cd frontend

# Install dependencies
npm install --legacy-peer-deps

# Start the development server
npm run dev

The frontend application will now be running on http://localhost:5173. Keep this terminal open.

5. Access the Application

With all three terminals running, open your web browser and navigate to: http://localhost:5173

🔐 Trial Access

For demonstration and testing purposes, you can use the following credentials:

📧 Email: raghdatarek@gmail.com 🔑 Password: raghda

🖥️ Application Overview

DICOM Server Status

You can monitor your DICOM server directly at:

  • Web Interface: http://localhost:8046
  • DICOM Port: 4246
  • Server Name: Mordent Dental PACS

🎓 From Academia to Application

MORDENT.AI proudly began as a graduation project for the Systems and Biomedical Engineering Department, Faculty of Engineering, Cairo University.

It was built with a clear vision: to transform rigorous academic research into a powerful and practical tool that enhances clinical diagnostics in orthodontics.

About

MORDENT.AI is an automated platform for cephalometric landmark detection and orthodontic analysis that leverages deep learning and graph neural networks. It integrates smoothly with clinical workflows through a DICOM viewer and medical image management system, enabling efficient and accurate orthodontic diagnosis and treatment planning.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors