Фотоловушка для котов (Cat Detection Camera Trap)

Автоматизированная система мониторинга с обнаружением котов с помощью модели YOLO11n. При срабатывании фотоловушка отправляет уведомление с фотографией и данными в Telegram.

---

О проекте

Данное устройство — фотоловушка, которая снимает видео с камеры и анализирует кадры, выделяя котов с помощью нейросети YOLO11n. При обнаружении кота система:

• Делает снимок с рамкой вокруг животного,
• Записывает дату, время и номер устройства,
• Отправляет уведомление в Telegram с фотографией и информацией о событии.

Управление и настройка происходят через удобного Telegram-бота.

---

Основные возможности

• Детекция котов в реальном времени (YOLO11n модель в формате ONNX)
• Отправка фотоуведомлений в Telegram
• Настройка Wi-Fi напрямую через Telegram-бота
• Просмотр статуса системы, камеры и журнала обнаружений
• Запись всех обнаружений в CSV-файл
• Антифлуд (кулдаун между срабатываниями)
• Интерактивное меню Telegram для управления

---

Технические характеристики

Параметр	Значение
Модель	YOLO11n (ONNX формат)
Порог уверенности	0.3
Размер входного кадра	320x320
Класс для детекции	15 (кот)
Кулдаун между срабатываниями	5 секунд
Папка сохранения данных	detections/
Язык	Python
Управление	Telegram-бот

---

Установка и запуск

1. Клонируйте репозиторий:

git clone https://github.com/AllaAndreevna/CatDetector-CV/
cd CatDetector-CV

3. Создайте и активируйте виртуальное окружение:

python -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows

3. Установите зависимости:

pip install -r requirements.txt

4. Поместите модель yolo11n.onnx в папку models/.

pip install ultralytics
yolo export model=yolo11n.pt format=onnx imgsz=320

Данная команда скачает модель с названием yolo11n.onnx в текущую директорию.

5. Отредактируйте в main.py:

• API_TOKEN (токен Telegram бота)
• USER_ID (ваш Telegram ID)
• При необходимости другие параметры (порог, кулдаун, ID камеры).

6. Запустите фотоловушку:

python main.py

---

Использование

• Отправьте команду /start вашему Telegram-боту.
• Просматривайте статус устройства, журнал обнаружений и настройки.
• При обнаружении кота получите уведомление с фото, рамкой и временем обнаружения.

---

Пример уведомления в Telegram

🐱 Фотоловушка 001: Обнаружен кот!
📍 Место: Камера 001
🕒 Время: 2025-07-30 11:00:05

Фото содержит выделенный прямоугольник вокруг кота и значение уверенности модели.

---

⭐Если вам понравилось, пожалуйста поставьте звездочку⭐