Skip to content

Repository files navigation

🍃 Shudh - Pure Food Checker

React TypeScript Vite License

Shudh revolutionizes how you shop for groceries by instantly analyzing food ingredients for health risks, harmful additives, and nutritional quality. Point your camera at any product label and get a clear safety score in seconds.


🚀 Features

  • 🔍 AI-Powered Label Scanning: Uses computer vision to detect and read ingredients from photos automatically
  • ⚠️ Ingredient Risk Analysis: Flags harmful additives, preservatives, artificial colors, and allergens with detailed explanations
  • 📊 Health Score Rating: Gets a 1-100 safety score based on nutritional guidelines and expert standards
  • 🎯 Personalized Alerts: Customize for dietary needs like vegan, diabetic-friendly, or allergy avoidance
  • ⚡ Fast & Offline Capable: Works instantly with optional cloud sync for database lookups
  • ✨ Clean, Intuitive UI: Built with modern React/TypeScript for seamless mobile and desktop experience

🛠️ Tech Stack

Frontend Backend Tools
React + TypeScript Google Gemini AI Vite Build Tool
HTML5 Camera API Open Food Facts API Computer Vision ML
Modern CSS Node.js Barcode Detection

📱 Demo

Scan any packaged food and watch Shudh break down hidden dangers:

📸 Snap photo → 🔍 AI Analysis → ✅ Safety Score: 82/100
⚠️ Flags: Artificial Sweetener (Aspartame), High Sodium
💡 Suggestion: Choose natural alternative

🚀 Quick Start

Prerequisites

  • Node.js 16+ installed
  • npm or yarn package manager
  • Modern web browser with camera access

Installation

  1. Clone the repository:
git clone https://github.com/Sai-Emani25/Shudh.git
cd Shudh
  1. Install dependencies:
npm install
  1. Run locally:
npm run dev
  1. Open your browser:

Navigate to http://localhost:5173

Deployment

Deploy to Vercel or Netlify with one click:

  1. Connect your GitHub repository
  2. Set build command: npm run build
  3. Set output directory: dist

🔮 Roadmap

  • Core scanning engine
  • Ingredient database integration
  • Barcode scanning (UPC/EAN)
  • User profiles & history
  • Multi-language support (Hindi + regional)
  • Android/iOS PWA install

🤝 Contributing

Contributions are welcome! We appreciate your help in making Shudh better.

How to Contribute

  1. Fork the project
  2. Create your feature branch
    git checkout -b feature/AmazingFeature
  3. Commit your changes
    git commit -m 'Add some AmazingFeature'
  4. Push to the branch
    git push origin feature/AmazingFeature
  5. Open a Pull Request

See CONTRIBUTING.md for more details.


📄 License

This project is licensed under the MIT License - Free to use, modify, and distribute.


👨‍💻 Author

Sai Emani

  • GitHub: @Sai-Emani25
  • Location: Bangalore, Karnataka, India

Built with ❤️ for a healthier India! 🇮🇳

About

Food checker

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages