https://github.com/dearabhin/bubble-tea-counter
Count Bubbles in your Tea!
https://github.com/dearabhin/bubble-tea-counter
bubbles bubbletea
Last synced: 4 months ago
JSON representation
Count Bubbles in your Tea!
- Host: GitHub
- URL: https://github.com/dearabhin/bubble-tea-counter
- Owner: dearabhin
- Created: 2025-08-10T04:04:54.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-08-10T05:26:06.000Z (11 months ago)
- Last Synced: 2025-08-10T06:20:34.758Z (11 months ago)
- Topics: bubbles, bubbletea
- Language: HTML
- Homepage: https://bubblelytics.onrender.com/
- Size: 5.82 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🥤 Bubblelytics: The AI Bubble Tea Counter
Tired of not knowing exactly how many bubbles are in your tea? Worry no more! We built a polished, multi-page web application that uses computer vision to analyze your tea and a dashboard to track the most bubbly submissions.
### Live Application Features
- **Modern, Multi-Page Interface:** A clean and professional design with separate pages for Home, Analysis, a Stats Dashboard, and a technical "How It Works" deep-dive.
- **AI-Powered Analysis:** Upload a photo, and our OpenCV-powered backend will detect and count the bubbles in seconds.
- **Interactive Dashboard:** The leaderboard is now a full dashboard showing key statistics like total teas analyzed, average bubble count, and the all-time high score.
- **Visual Feedback:** See exactly how the AI identified the bubbles with detailed process and final result images.
## Technical Stack
- **Backend:** Python, Flask
- **Frontend:** HTML, Tailwind CSS
- **Image Processing:** OpenCV, NumPy, Matplotlib
- **Database:** SQLite
## How to Run
1. **Set up Environment:**
```bash
# Create a virtual environment
python -m venv venv
# Activate it
# Windows
.\venv\Scripts\activate
# macOS/Linux
source venv/bin/activate
```
2. **Install Dependencies:**
```bash
pip install Flask opencv-python numpy matplotlib
```
3. **Run the App:**
```bash
# This will initialize the database and start the server
python app.py
```
4. **View in Browser:**
Open `http://127.0.0.1:5000` in your web browser.
---
Made with ❤️ and lots of bubbles.