PharmaPulse AI

PharmaPulse AI is a Streamlit-based pharmaceutical supply chain dashboard built to support demand forecasting, shortage risk visualization, redistribution recommendations, and medicine alternative insights.

Project Structure

• app.py - main Streamlit application launcher
• pipeline.py - automation and generative summary logic
• Phase_4/ - dashboard page modules for Overview, Demand Forecast, Shortage Map, Redistribution, and Medicine Alternatives
• pharma_pulse.db - SQLite database used by the app
• outputs/ - generated output files for supplier orders and reports

Features

• Interactive pharmacy dashboard with multiple pages
• Demand forecast and shortage risk analysis
• Redistribution and stock balancing recommendations
• AI-driven summary generation using Groq LLM (optional)

Installation

1. Create a Python virtual environment:

   python -m venv .venv
   .venv\Scripts\activate

2. Install dependencies:

   pip install -r requirements.txt

3. Make sure the pharma_pulse.db file is present in the project root and contains the required tables.

Run the app

streamlit run app.py

Then open the local URL shown in the terminal.

Notes

• The app expects a local SQLite database file named pharma_pulse.db.

Dependencies

This project uses at least:

• streamlit
• pandas
• plotly
• groq (optional, only if you want AI summary generation)

If you add other packages in the future, add them to requirements.txt.