File size: 3,225 Bytes
036421e
 
217866d
 
 
036421e
 
 
 
217866d
036421e
 
217866d
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
---
title: Cat Breed Classifier
emoji: 🐱
colorFrom: green
colorTo: red
sdk: gradio
sdk_version: 3.16.1
app_file: app.py
pinned: false
license: openrail
---

# \[EN\] Cat Breed Classifier

This is an app that can classify the breed of a cat based on a photo.

It uses a VGG-16 ImageNet model finetuned on images of cats of various breeds. The model is able to recognize a 20 of breeds.

## Requirements

- Python 3.8 or higher
- Gradio 3.15.0
- Tensorflow 2.10
- Numpy 1.23.3
- Requests 2.25.1
- Pillow 9.0.1
- FastApi 0.88.0
- Uvicorn 0.20.0 or higher

## How to use

1. Clone repository using `git clone https://github.com/DenkingOfficial/cat_breed_classifier.git`
2. Enter the cloned directory `cd cat_breed_classifier`
3. Install requirements by running `pip install -r requirements.txt`
4. Download a model from [here](https://www.dropbox.com/s/iga6rfyqpq0lnra/20_cat_classes_model.h5) and place it into `models` folder
5. Run app using `uvicorn app:app`

## Authors

This app was developed by students of Ural Federal University (UrFU):

- Shershnev Andrey, RIM-120907 - Model Training, App Development
- Ivanov Sergey, RIM-120906 - API Development, Dataset collection
- Shalaeva Irina, RIM-120906 - UI Styling, Dataset collection
- Ilyin Semen, RIM-120907 - App Development, Dataset collection

---

# \[RU\] Классификатор пород кошек

Это веб-приложение, которое позволяет определять породу кошки по фотографии.

Оно использует модель VGG-16 ImageNet тонко настроенную на изображениях кошек разных пород. Данная модель позволяет определять 20 пород.

## Зависимости

- Python 3.8 или новее
- Gradio 3.15.0
- Tensorflow 2.10
- Numpy 1.23.3
- Requests 2.25.1
- Pillow 9.0.1
- FastApi 0.88.0
- Uvicorn 0.20.0 или новее

## Как использовать

1. Загрузить репозиторий используя команду `git clone https://github.com/DenkingOfficial/cat_breed_classifier.git`
2. Перейти в директорию репозитория `cd cat_breed_classifier`
3. Установить зависимости используя команду `pip install -r requirements.txt`
4. Скачать модель [отсюда](https://www.dropbox.com/s/iga6rfyqpq0lnra/20_cat_classes_model.h5) и скопировать ее в папку `models`
5. Запустить приложение используя команду `uvicorn app:app`

## Авторы

Это приложение было разработано студентами Уральского Федерального университета (УрФУ):

- Шершнев Андрей, РИМ-120907 - тренировка модели, разработка приложения
- Иванов Сергей, РИМ-120906 - разработка API, сбор датасета
- Шалаева Ирина, РИМ-120906 - стилизация интерфейса, сбор датасета
- Ильин Семен, РИМ-120907 - разработка приложения, сбор датасета