Skip to content

ahamitd/notifyai

Repository files navigation

NotifyAI - Yapay Zeka Destekli Bildirim Sistemi

NotifyAI Logo


📖 Genel Bakış

NotifyAI, Home Assistant için geliştirilmiş profesyonel bir yapay zeka bildirim sistemidir. Standart otomasyon uyarılarınızı, akıllı, insan gibi ve görsel olarak farkında bildirimlere dönüştürür.

Sıradan "Hareket algılandı" yerine:

🎭 Eğlenceli Mod: "Bahçede biri dolaşıyor, misafir mi yoksa komşunun kedisi mi? 🐱"
🧠 Zeki Mod: "Bahçede hareket tespit edildi. Alarm aktif, gece 23:45."
👔 Resmi Mod: "Güvenlik uyarısı: Bahçe sensörü tetiklendi."


✨ Özellikler

🎯 Temel Özellikler

  • 🇹🇷 Tam Türkçe: Tüm bildirimler Türkçe olarak üretilir
  • ⚡ Sıfır Bağımlılık: Hiçbir dış kütüphane gerektirmez, her Home Assistant'ta çalışır
  • 🎨 5 Farklı Mod: Eğlenceli, Zeki, Resmi, Sert, Karışık
  • 🤖 2 AI Provider: Gemini (1500/gün) veya Groq (14,400/gün)
  • 📱 Çoklu Cihaz: Ayarlardan 4 cihaza kadar tanımlayın, tüm cihazlara otomatik gönderim

🚀 İleri Seviye Özellikler

  • 📸 Görsel Zeka (Vision): Kamera görüntüsü gönderin, AI ne olduğunu görsün
    • Örnek: "Kapıda kargocuyla paket var" veya "Bahçede kedi dolaşıyor"
  • 🎭 Karakter Sistemi (Personas): AI'ya bir karakter verin
    • Jarvis, Sinirli Bekçi, Komik Anne, Sarkastik Robot vs.
  • 🧠 Akıllı Bağlam: Ev durumunu (alarm, gece modu vs.) anlayarak bildirim üretir
  • ✏️ Özel Başlık: İsterseniz başlığı siz yazın, isterseniz AI üretsin

📦 Kurulum

HACS ile Kurulum (Önerilen)

  1. HACS'i açın (Yan menü > HACS)
  2. Entegrasyonlar sekmesine gidin
  3. Sağ üstteki (üç nokta) > Özel depolar
  4. Şu URL'yi ekleyin:
    https://github.com/ahamitd/notifyai
    
  5. Kategori: Integration seçin
  6. Ekle butonuna tıklayın
  7. HACS'te "NotifyAI" arayın
  8. İndir butonuna tıklayın
  9. Home Assistant'ı yeniden başlatın

Manuel Kurulum

  1. Bu repoyu indirin (Code > Download ZIP)
  2. custom_components/notifyai klasörünü Home Assistant'ınızın config/custom_components/ dizinine kopyalayın
  3. Home Assistant'ı yeniden başlatın

⚙️ Yapılandırma

1. Entegrasyonu Ekleyin

  1. Ayarlar > Cihazlar & Hizmetler > Entegrasyon Ekle
  2. "NotifyAI" arayın
  3. AI Provider Seçin:
    • Gemini: 1500 istek/gün, yüksek kalite
    • Groq: 14,400 istek/gün (9.6x daha fazla!), çok hızlı
  4. API Anahtarınızı girin

2. Bildirim Cihazlarını Tanımlayın (Opsiyonel)

  1. Ayarlar > Cihazlar & Hizmetler > NotifyAI kartını bulun
  2. Yapılandır butonuna tıklayın
  3. 4 cihaza kadar bildirim servisi ekleyin:
    • Örnek: notify.mobile_app_iphone
    • Örnek: notify.mobile_app_android
    • Örnek: notify.salon_tv

Artık otomasyonlarda notify_service belirtmeden tüm cihazlara otomatik gönderim yapılır!


🎮 Kullanım

Basit Kullanım

service: notifyai.generate
data:
  event: "Bahçe kapısı açıldı"
  mode: "fun"

Sonuç:

  • Başlık: "Kapı Açıldı! 🚪"
  • Mesaj: "Bahçe kapısı açıldı, misafir mi geldi yoksa kedi mi kaçtı? 🐱"

Tüm Parametreler

service: notifyai.generate
data:
  event: "Hareket algılandı"              # Zorunlu: Ne olduğunu yazın
  custom_title: "🚨 Güvenlik Uyarısı"     # Opsiyonel: Özel başlık
  context: "Alarm aktif, gece modu açık"  # Opsiyonel: Ev durumu
  mode: "smart"                           # Opsiyonel: fun, smart, formal, mixed
  persona: "Jarvis"                       # Opsiyonel: AI karakteri
  image_path: "/config/www/kapi.jpg"      # Opsiyonel: Görsel analizi
  notify_service: "notify.mobile_app"     # Opsiyonel: Belirli cihaz

📸 Görsel Zeka Örneği

Kamera görüntüsünü analiz ederek bildirim üretir:

service: notifyai.generate
data:
  event: "Kapıda biri var"
  image_path: "/config/www/doorbell_snapshot.jpg"
  mode: "smart"

AI'nın Göreceği: Görüntüdeki kişi, nesne, durum
Üretilen Bildirim: "Kapıda kargocuyla paket var, imzalı teslimat bekliyor."


🎭 Karakter Sistemi Örnekleri

Jarvis (Iron Man'in AI'ı)

service: notifyai.generate
data:
  event: "Bulaşık makinesi bitti"
  persona: "Jarvis"

Sonuç: "Efendim, bulaşıklar temizlendi. Mutfak görevleri tamamlandı."

Sarkastik Robot

service: notifyai.generate
data:
  event: "Çöp kutusu dolu"
  persona: "Sarkastik Robot"

Sonuç: "Çöp kutusu dolmuş, ama tabii acele etmeyin, ben sadece bir robotum. 🤖"


🔧 Gelişmiş Kullanım

Otomasyonda Kullanım

automation:
  - alias: "Akıllı Kapı Bildirimi"
    trigger:
      - platform: state
        entity_id: binary_sensor.kapi
        to: "on"
    action:
      - service: notifyai.generate
        data:
          event: "Ön kapı açıldı"
          context: "Evde kimse yok"
          mode: "smart"

Görsel Analiz ile Otomasyon

automation:
  - alias: "Kapı Zili - Görsel Analiz"
    trigger:
      - platform: state
        entity_id: binary_sensor.doorbell
        to: "on"
    action:
      - service: camera.snapshot
        target:
          entity_id: camera.kapi
        data:
          filename: "/config/www/doorbell_snapshot.jpg"
      - delay: "00:00:02"
      - service: notifyai.generate
        data:
          event: "Kapı zili çaldı"
          image_path: "/config/www/doorbell_snapshot.jpg"

🎨 Mod Açıklamaları

Mod Açıklama Örnek
fun Eğlenceli, şakacı, emoji kullanır "Kapı açıldı, misafir mi geldi yoksa kedi mi kaçtı? 🐱"
smart Zeki, bilgilendirici, net "Ön kapı açıldı. Alarm aktif, saat 23:45."
formal Resmi, profesyonel, emoji yok "Güvenlik uyarısı: Ön kapı sensörü tetiklendi."
sert Direkt, filtresiz, sert mizah "Kapı yine açık kaldı lan!"
mixed Rastgele mod seçer Her seferinde farklı ton

💡 İpucu: "sert" modu Groq provider ile daha iyi çalışır (daha az sansür)


❓ Sık Sorulan Sorular

Ücretli mi?

Hayır! Hem Gemini hem Groq ücretsiz. Groq 14,400 istek/gün limit sunuyor!

Hangi AI provider'ı seçmeliyim?

  • Gemini: Daha yüksek kalite, görsel analiz destekli (1500/gün)
  • Groq: Çok daha hızlı, 9.6x daha fazla limit (14,400/gün)

OpenAI destekliyor mu?

Hayır, sadece Google Gemini ve Groq. Protobuf çakışması olmadan çalışması için REST API kullanıyoruz.

Bildirimler nereye gider?

Ayarlarda tanımladığınız cihazlara otomatik gider. Veya notify_service parametresiyle belirli bir cihaza gönderebilirsiniz.

Görsel analizi nasıl çalışır?

Kamera görüntüsünü Google Gemini'ye gönderir, AI görseli analiz eder ve bildirimi ona göre üretir.


🤝 Katkıda Bulunma

Katkılarınızı bekliyoruz! Pull request göndermekten çekinmeyin.

  1. Fork yapın
  2. Feature branch oluşturun (git checkout -b feature/amazing-feature)
  3. Commit yapın (git commit -m 'Add amazing feature')
  4. Push edin (git push origin feature/amazing-feature)
  5. Pull Request açın

📄 Lisans

MIT License - Detaylar için LICENSE dosyasına bakın.


🙏 Teşekkürler

  • Google Gemini API
  • Home Assistant Community
  • HACS

Made with ❤️ for Home Assistant

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages