README.md

metadata

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 - 13,000+ international products
• Korea Food Safety Database (식품안전나라) - Korean market products
• Veterinary research on harmful pet food ingredients

Local Development

# 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
• Dataset: Open Pet Food Facts

---

Made with ❤️ for pet safety

Version 1.0 (2025)