🚀 CardioAI & GDP Dashboard — AI × Beautiful UI/UX ✨

🔥 Live Demo — Heart Disease Predictor   •   🌍 Live Demo — GDP Dashboard

---

⚡ TL;DR — Why this repo = instant scroll stopper

• Interactive, deployable Streamlit apps that transform raw data into beautiful, explorable visuals.
• AI model (Heart disease prediction) + Economic visualizer (GDP trends).
• UX-first design: animations, crisp charts, clear CTAs, bilingual support options.
• Ready-to-demo — share live links, short GIFs, and a slick README = recruiter magnet.

---

✨ Animated Demos (copy these filenames into assets/)

  

File names expected (put these in /assets):
banner.gif, demo_heart.gif, demo_gdp.gif, screenshot1.png, screenshot2.png, screenshot3.png

---

🔎 Feature Highlights

• Heart Disease Predictor
  • Fast inference with a RandomForest classifier
  • SHAP-based explainability (feature impact)
  • Clear probability + confidence UI
• GDP Dashboard
  • Country comparators, year-range sliders, export CSV
  • Interactive Plotly charts (zoom/pan)
• UX/Accessibility
  • Responsive layout, Hindi/English labels option, color-blind safe palettes
  • Local processing — no user data is stored

---

🎨 UI / UX DESIGN GUIDE (colors, fonts, animations)

Use these to keep a consistent brand/professional look.

Primary palette

• Accent Blue: #0077CC
• Deep Teal: #005f73
• Action Red: #ff4b4b
• Soft Gray (background cards): #f6f8fa
• Text: #0b1220

Fonts (for banner/design assets / web)

• Headline: Poppins / Inter
• Body: Roboto / Open Sans

Animation suggestions

• Hero banner: subtle left→right parallax + glowing title (GIF or APNG)
• Demo GIFs: screen-record 6–12s loops showing the main flow (LICEcap / ScreenToGif / Record with OBS → trim)
• Micro animations: progress bars / metric counters (use streamlit-animation libs or Lottie)

---

📸 How to create the assets (quick)

• Banner (animated): Figma or Canva — create 1200×400 px canvas, animate text + icons, export as GIF/APNG.
• Demo GIFs: Use ScreenToGif (Windows) or Peek (Linux) to capture the app flow (6–10s), crop & optimize with ezgif.com.
• Optimize images: TinyPNG or Squoosh — keep each < 2MB for fast GitHub load.

---

🧭 Installation & Run (local dev)

# clone
git clone https://github.com/<your-username>/<your-repo>.git
cd <your-repo>

# recommended: create venv
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate

# install
pip install -r requirements.txt

# run one of the apps (example)
streamlit run src/heart_app.py
# or
streamlit run src/gdp_app.py