MediScan AI

MediScan AI is an interactive web app designed for breast cancer education and awareness. Built on top of the open-source ollama-ui project, this application uses a locally hosted AI Language Model (Llama 3.2 via Ollama) to serve as a smart, empathetic, and witty medical assistant named Lina.

This project is tailored to be deployed on local IT infrastructure (such as school labs or community centers) to help educate the girl child on healthy breast practices, how to perform self-exams, and general breast health.

Features

• Local AI Chat Assistant (Lina): Empathetic and responsive conversational agent powered by Llama 3.2.
• Educational Resources: Informative guides and tips on breast hygiene, self-exams, and warning signs.
• Privacy-First: Since it relies on local infrastructure (Ollama), user interactions and data remain entirely on the local network.
• Modern UI/UX: A visually stunning, responsive interface built to keep users engaged while learning.

Setup & Deployment

To run this project locally:

1. Make sure you have Ollama installed and running locally with the Llama 3.2 model (ollama run llama3.2).
2. Run the simple local web server:

   ./run-locally.sh
   # Or using python directly: python3 -m http.server --bind 127.0.0.1 8000
   # Or open project in VSCode and press Ctrl+L to open in browser

3. Open http://localhost:8000 in your web browser.

Team

This project was developed by Group 7 as a semester project for the course Artificial Intelligence (2024/2025) (Computer Science, Year 3 KNUST):

Lecturer: Dr. Kwabena Owusu Agyemang

• Etornam Ahiataku (Project Manager) - ahiataku1@gmail.com
• John Dagadu David (FrontEnd Developer) - johndagadu72@gmail.com
• Elorm Seyram Adzo (DevOps Engineer) - elorm@email.com
• Honu K. Destine (Backend Developer) - honudestine933@gmail.com
• Mensah Justin (UI/UX Designer) - jstmensa111@gmail.com
• Opoku Davies (UI/UX Designer) - opokudavies678@gmail.com
• Caleb Awuah (FrontEnd Developer) - caleb@gmail.com
• Abdul Rafui (DevOps Engineer) - shasudeenrafiu22@gmail.com
• Antwi Collins Seth (Backend Developer) - collinsseth900@gmail.com