Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

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

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors