Ever wondered "What breed is that adorable dog?" 🤔

DoggyDex is your AI-powered dog breed identification companion that can instantly recognize over 100+ dog breeds from a single photo! Built with cutting-edge machine learning and a sleek web interface, it's like having a canine expert in your pocket.

# Clone the repository
git clone https://github.com/yourusername/doggydex.git
cd doggydex

# Build and run with Docker
docker build -t doggydex .
docker run -p 5001:5001 doggydex

# Install dependencies with Poetry
poetry install

# Activate virtual environment
poetry shell

# Run the application
python app.py

Visit http://localhost:5001 and start identifying dogs! 🎉

doggydex/
├── 🐍 app.py                 # Application entry point
├── 🔧 pyproject.toml         # Project configuration
├── 🐳 Dockerfile             # Container configuration
├── 🧠 models/                # ML model files
│   ├── dognet-convnext_large.pth
│   └── dognext_large_quantized.pth
├── 🌐 website/               # Web application
│   ├── 🎨 static/           # CSS, JS, images
│   ├── 📄 templates/        # HTML templates
│   ├── 🔍 identifier.py     # ML inference logic
│   └── 🎯 views.py          # Route handlers
└── 🔐 certs/                # SSL certificates

graph LR
    A[📸 Upload Photo] --> B[🔍 Preprocess Image]
    B --> C[🧠 ConvNeXt Model]
    C --> D[📊 Confidence Score]
    D --> E[✨ Display Results]

1. 📸 Upload - Take or select your dog photo
2. 🔍 Process - Image preprocessing and normalization
3. 🧠 Analyze - ConvNeXt Large model inference
4. 📊 Score - Confidence percentage calculation
5. ✨ Results - Beautiful breed identification display

• 🎯 Accurate: Trained on thousands of dog images
• ⚡ Fast: Optimized for real-time inference
• 🎨 Beautiful: Modern, responsive design
• 🔒 Secure: HTTPS-ready with SSL support
• 🐳 Scalable: Docker containerization
• 🆓 Free: Open source and free to use

We love contributions! 💖

• 🐛 Report bugs - Help us improve
• ✨ Suggest features - Share your ideas
• 📝 Improve docs - Make it clearer
• 🧠 Train models - Better accuracy
• 🎨 Design UI - Enhanced experience

This project is licensed under the MIT License - see the LICENSE file for details.