KairoMed
Table of Contents
- About the Solution
- Key Features
- Architecture
- Tech Stack
- Getting Started
- Demo
- Contributing
- License
About the Solution
Managing medication schedules for yourself and loved ones--children, elders, or family members--can be overwhelming. KairoMed centralizes this process in one intuitive interface, allowing you to:
- Track and organize multiple medication regimens in a unified dashboard
- Receive smart reminders for each dose and time
- Lookup detailed drug information instantly
- Discover alternative options based on active ingredients
This integrated approach ensures better adherence, reduces human error, and gives peace of mind when caring for family members with diverse medication needs.
Key Features
| Feature | Benefit |
|---|---|
| Medication Scheduling | Add, view, and edit schedules for multiple users |
| Medication Info Lookup | Fuzzy search of 11,000+ medicines with AI fallback |
| Alternative Medicine Finder | Suggests drugs sharing active ingredients |
| Secure Data Storage | Supabase Postgres backend with robust search capabilities |
| Responsive UI | Smooth, minimal interface built with Next.js |
Architecture
+----------+ HTTPS +-------------+ SQL/API +--------------+
| Next.js | --------------> | FastAPI | ----------------> | Supabase |
| Frontend | | Backend | | Postgres |
+----------+ +-------------+ +--------------+
Tech Stack
- Frontend: Next.js, React, Tailwind CSS
- Backend: FastAPI, Pydantic, Google Generative AI (Gemini)
- Database: Supabase Postgres with
pg_trgmextension - Deployment: Vercel (frontend), Render (backend)
Getting Started
Prerequisites
- Node.js v18+ & npm
- Python 3.11+ & virtualenv
- Supabase project with
medicine_infotable andsearch_medicine_trgmfunction
Installation
-
Clone the repo:
git clone https://github.com/Priyans00/KairoMed.git
cd KairoMed -
Setup Frontend:
cd frontend
npm install
npm run dev -
Setup Backend:
cd ../backend
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt
uvicorn main:app --reload --port 8000
Environment Variables
Create .env in backend/:
SUPABASE_URL=https://.supabase.co
SUPABASE_SERVICE_ROLE_KEY=
GEMINI_API_KEY=
Demo
Live at https://kairomed.vercel.app
Contributing
- Fork the repo
- Create a feature branch (
git checkout -b feature/...) - Commit (
git commit -m "feat: ...") - Push & open PR
License
MIT (c) 2025 Priyans