Fadhal1/mediaid-chatbot

MediAid – Local Drug Finder & Health Advice Chatbot MediAid is a lightweight, offline-capable chatbot designed to provide fast, accessible drug recommendations and health advice for common diseases in Nigeria and across Africa. Built for community health workers, students, and the general public. # MediAid - Health Companion > MediAid is a web-based health chatbot that provides instant drug recommendations and preventive health advice for common conditions. It uses a local dataset and can fall back to Google Gemini AI for professional, friendly answers. ## Features - Chatbot interface for health questions - Local dataset for fast, offline answers - Gemini AI fallback for broader health advice - Modern, mobile-friendly UI (Tailwind CSS) ## Prerequisites - Python 3.8 or higher - Google Gemini API key ## Setup Instructions ### 1. Clone the repository ```bash git clone github.com cd mediaid ``` ### 2. Set up Python environment ```bash python -m venv .venv # On Windows: .venv\Scripts\activate # On macOS/Linux: source .venv/bin/activate ``` ### 3. Install dependencies ```bash pip install -r requirements.txt ``` ### 4. Configure environment variables 1. Copy `.env.example` to `.env`: ```bash cp .env.example .env ``` 2. Edit `.env` and add your Gemini API key: ``` GEMINI_API_KEY=your_actual_gemini_api_key_here ``` ### 5. Run the application **Start the backend:** ```bash python main.py ``` The API will be available at `localhost` **Serve the frontend:** ```bash python -m http.server 8080 ``` Then open localhost ## Getting a Gemini API Key 1. Go to Google AI Studio 2. Sign in with your Google account 3. Create a new API key 4. Copy the key and add it to your `.env` file ## API Endpoints - `GET /` - API status - `GET /health` - Health check with configuration status - `POST /api/ai` - AI chat endpoint ## Deployment ### Environment Variables for Production - `GEMINI_API_KEY` - Your Gemini API key ### Recommended Platforms - **Backend**: Render, Railway, Fly.io, or Heroku - **Frontend**: Netlify, Vercel, or GitHub Pages ### Deployment Steps 1. Push your code to GitHub (API key will be ignored due to .gitigno …