Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 

Repository files navigation

πŸ¦… FeatherCam

An open-source, subscription-free AI bird camera powered by ESP32-S3 & BYOK / Local Vision AI. Natively integrated with Home Assistant.

License: MIT Hardware: ESP32-S3 Home Assistant Discord


✨ Features

  • πŸ’° No Vendor Lock-in or Forced Subscriptions: Your hardware, your rules. Zero monthly cloud paywalls. Operates on a BYOK (Bring Your Own Key) modelβ€”pair seamlessly with Google Gemini's generous Free Tier API ($0/mo for typical backyard use), OpenAI, or 100% local AI models.
  • ⚑ Ultra-Low Power Deep Sleep: Driven by hardware PIR interrupts (AM312). Optimized for battery + solar panel outdoor deployment.
  • 🧠 Flexible Vision AI Integration: Leverages multimodal models (Gemini / OpenAI GPT-4o) or self-hosted local AI (Ollama / LLaVA via Home Assistant) for fine-grained bird species identification and behavior insights.
  • πŸŽ₯ High-Res Capture & Pre-buffering: Pre-buffers camera frames into 8MB PSRAM during Wi-Fi connection to ensure the bird's arrival is never missed.
  • 🏠 Native Home Assistant Integration: Local-first automation support via MQTT and REST endpoints.
  • πŸ”” Instant Multi-Channel Alerts: Real-time notification updates with media previews via Discord Webhooks, Telegram, or Email digests.

πŸ—οΈ Architecture

[ Physical World ]
       β”‚
       β–Ό
[ AM312 PIR Sensor ] ──(Physical Motion Interrupt)──> [ ESP32-S3-CAM ]
                                                           β”‚
                                                           β”œβ”€ 1. Cache frames to PSRAM
                                                           └─ 2. Push media payload via HTTP
                                                                   β”‚
                                                                   β–Ό
                                                     [ EdgeForgeLab Python Server ]
                                                                   β”‚
                                                                   β”œβ”€ Video / GIF Processing
                                                                   β”œβ”€ Vision AI Species Identification
                                                                   └─ Push to Discord / Home Assistant

About

An open-source, subscription-free AI bird camera powered by ESP32-S3 & BYOK/Local AI. Natively integrated with Home Assistant.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors