💊 PharmAssist - AI Powered Medication Assistance System

PharmAssist is a full-stack AI-powered healthcare web application that helps users search medicines, manage prescriptions, discover alternative medicines, and receive AI-assisted medication guidance through an interactive chatbot.

Built using React, FastAPI, SQLite, and OpenRouter (Google Gemma 4 LLM), the application provides a modern, responsive, and user-friendly platform for accessing medicine-related information.

---

🚀 Live Demo

🌐 Live Application: http://18.211.129.56/

---

📌 Features

• 🔍 Search medicines by name
• 💊 View medicine details
  • Salt composition
  • Price
  • Description
  • Side effects
  • Status
• 🤖 AI-powered Medication Assistant
• 📋 Prescription Management
• 🔄 Similar Medicine Recommendations
• 📱 Responsive and modern UI
• ⚡ Fast REST API communication
• 🗄 SQLite database integration

---

🛠 Tech Stack

Frontend

• React
• Vite
• Axios
• CSS
• Framer Motion
• Lucide React

Backend

• FastAPI
• Python
• SQLModel
• SQLite

AI

• OpenRouter API
• Google Gemma 4 LLM

Tools

• Git
• GitHub
• VS Code

---

🏗 System Architecture

User
   │
React Frontend
   │
REST API (Axios)
   │
FastAPI Backend
   │
├── Medicine Search
├── Prescription Management
├── Similar Medicine Recommendation
└── AI Chatbot
      │
      ├── SQLite Database (via SQLModel)
      └── OpenRouter API
             │
             └── Google Gemma 4 LLM

---

📂 Project Structure

PharmAssist/
│
├── frontend/
│   ├── src/
│   ├── components/
│   ├── services/
│   └── context/
│
├── backend/
│   ├── app/
│   ├── database.py
│   ├── models.py
│   ├── chatbot.py
│   └── main.py
│
└── README.md

---

⚙ Installation

Clone the Repository

git clone https://github.com/SamarthKini/PharmAssist.git

cd PharmAssist

---

Backend Setup

cd backend

python -m venv venv

source venv/bin/activate
# Windows
venv\Scripts\activate

pip install -r requirements.txt

uvicorn app.main:app --reload

---

Frontend Setup

cd frontend

npm install

npm run dev

---

📷 Application Features

🔍 Medicine Finder

• Search medicines instantly
• View medicine composition
• Check side effects
• View pricing
• Medicine descriptions

🤖 Medication Assistant

• AI-powered chatbot
• Dosage guidance
• Safety precautions
• Drug interaction assistance
• Medicine-related Q&A

💊 Prescription Management

• Add medicines
• Remove medicines
• Maintain current prescription
• Use prescription context during AI conversations

🔄 Similar Medicines

• View alternative medicines
• Compare medicines
• Add alternatives directly to prescription

---

👨‍💻 Contributors

• Samarth S Kini
• Harshini Sapare

---