How douglasteyh/pesquisa-yolo-esp32cam-deteccao works
VenomESP monitors environments with an ESP32-CAM and a FastAPI service: the camera sends images, the service runs trained animal detectors, and detections can trigger Telegram alerts. Separate webcam programs provide local detection, while training notebooks and stored weights represent the model-development lifecycle. The README documents these major integrations; some implementation details, including firmware transmission and model-loading code, were not sampled, so those links rely on README evidence.
Main entry points: main.py FastAPI Image API · cobras_best.pt Snake Weights · escorpioes_best.pt Scorpion Weights · esp32cam_firmware.ino ESP32-CAM Firmware
Components 14
Image Capture
- ESP32-CAM Firmware
esp32cam_firmware/esp32cam_firmware.ino
Detection Service
- FastAPI Image API
api/main.py - YOLO Inference
api/main.py
Models and Training
- Snake Weights
pesos/cobras_best.pt - Scorpion Weights
pesos/escorpioes_best.pt - Snake Training
treinamento/notebook_treinamento_cobras.ipynb - Scorpion Training
treinamento/notebook_treinamento_escorpioes.ipynb
Local Detection
- Snake Webcam Detector
webcam/detector_cobras.py - Scorpion Webcam Detector
webcam/detector_escorpioes.py
Device Alerts
- Device Registry
api/main.py - Telegram Bot Polling
api/main.py
Other components
- Monitored Area
- Telegram
- Local Webcam
Connections 15
- Monitored Area → ESP32-CAM Firmware: captures images
README.md - ESP32-CAM Firmware → FastAPI Image API: uploads images
README.md - FastAPI Image API → YOLO Inference: runs detection
README.md - YOLO Inference → Snake Weights: uses weights
README.md - YOLO Inference → Scorpion Weights: uses weights
README.md - FastAPI Image API → Device Registry: reads device mapping
api/main.py - Telegram Bot Polling → Device Registry: registers devices
api/main.py - Telegram Bot Polling → Telegram: polls and replies
api/main.py - FastAPI Image API → Telegram: sends detection alerts
README.md - Snake Training → Snake Weights: trains model
README.md - Scorpion Training → Scorpion Weights: trains model
README.md - Local Webcam → Snake Webcam Detector: provides frames
README.md - Local Webcam → Scorpion Webcam Detector: provides frames
README.md - Snake Webcam Detector → Snake Weights: uses weights
README.md - Scorpion Webcam Detector → Scorpion Weights: uses weights
README.md