README.md

---
title: BarkScan - Pet Food Safety Analyzer
emoji: 🐾
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 5.9.1
app_file: app.py
pinned: false
license: mit
---

# 🐾 BarkScan - Pet Food Safety Analyzer

**Scan pet food barcodes to check ingredient safety instantly!**

BarkScan is an AI-powered pet food ingredient analyzer that helps pet owners make informed decisions about their pets' nutrition and safety.

## Features

- 📱 **Mobile-Friendly**: Works on any device with camera support
- 🔍 **Barcode Scanner**: Automatic barcode detection from images
- ⚠️ **Harmful Substance Detection**: Identifies 10+ dangerous ingredients
- 🎯 **Safety Grading**: A+ to F rating system (0-100 score)
- 🌐 **Multilingual**: Supports English and Korean products
- 📊 **Nutritional Analysis**: Protein, fat, fiber breakdown

## How to Use

1. **Upload a photo** of the pet food barcode or **use your camera** (mobile devices automatically use rear camera)
2. Click **"Scan & Analyze"**
3. View the **safety grade**, **harmful substances**, and **nutritional information**

## Sample Test Barcodes

Try these barcodes to see how BarkScan works:

- **8801234567890** - Royal Canin Mini Adult (Grade A - High quality)
- **8801234567898** - Budget Dog Food (Grade D - ⚠️ Contains BHA & Ethoxyquin)
- **8801234567899** - Orijen Original Dog (Grade A+ - Premium quality)

## Detected Harmful Substances

BarkScan identifies:

- **BHA/BHT** (Preservatives - Potential carcinogens)
- **Ethoxyquin** (Pesticide - Banned in human food)
- **Propylene Glycol** (May cause anemia in cats)
- **Artificial Colors** (Allergic reaction risk)
- **Meat By-Products** (Low-quality protein)
- **Carrageenan** (Digestive inflammation)
- And more...

## Safety Grading System

| Grade | Score | Description |
|-------|-------|-------------|
| A+ | 90-100 | Excellent - Premium quality ingredients |
| A | 80-89 | Very Good - High quality with minor concerns |
| B | 70-79 | Good - Acceptable quality |
| C | 60-69 | Fair - Some concerns |
| D | 50-59 | Poor - Multiple harmful substances |
| F | 0-49 | Very Poor - Avoid |

## Technology Stack

- **Frontend**: Gradio 4.44.0 (2025 latest)
- **Computer Vision**: OpenCV + ZBar/Pyzbar
- **Barcode Detection**: Pyzbar
- **Data Source**: Open Pet Food Facts, Korea Food Safety Database

## Data Sources

- [Open Pet Food Facts](https://world.openpetfoodfacts.org/) - 13,000+ international products
- Korea Food Safety Database (식품안전나라) - Korean market products
- Veterinary research on harmful pet food ingredients

## Local Development

```bash
# Clone the repository
git clone https://huggingface.co/spaces/YOUR_USERNAME/barkscan
cd barkscan

# Install dependencies
pip install -r requirements.txt

# Run the app
python app.py
```

## Project Structure

```
huggingface/
├── app.py              # Main Gradio application
├── requirements.txt    # Python dependencies
└── README.md          # This file
```

## Roadmap

- [ ] Real-time API integration with backend database
- [ ] OCR for ingredient list scanning
- [ ] AI-powered personalized recommendations
- [ ] Price comparison with online stores
- [ ] Community reviews and ratings
- [ ] Vet consultation integration

## Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

## License

MIT License - see LICENSE file for details

## Disclaimer

BarkScan is designed to help pet owners make informed decisions, but it should not replace professional veterinary advice. Always consult with your veterinarian about your pet's diet and health.

## Contact

- **Project**: [BarkScan GitHub](https://github.com/YOUR_USERNAME/BarkScan)
- **Dataset**: [Open Pet Food Facts](https://world.openpetfoodfacts.org/)

---

**Made with ❤️ for pet safety**

*Version 1.0 (2025)*