✦ Resonance — AI-Powered Not Sistemi

Yapay zeka destekli, notlarınızı sorgulayan, bağlantılar kuran ve fikir evriminizi takip eden akıllı not alma uygulaması.

🌟 Özellikler

🧠 AI-Destekli Not Yönetimi

• Atomik İddialar: Her not otomatik olarak atomik iddialara ayrıştırılır
• Insight Cards: Her notun özet kartı oluşturulur ve zamanla güçlenir
• Sokratik Sorular: AI, notlarınızı derinleştirmek için özel sorular sorar
• Otomatik Bağlantılar: Notlar arası semantik bağlantılar otomatik keşfedilir

📊 Görselleştirme

• İnteraktif Graf: Obsidian tarzı, notlarınızı görselleştiren interaktif graf
• Renk Kodlama: Güncelleme sıklığına göre renklendirme (mor → kırmızı → sarı → mavi)
• Sürükle-Bırak: Düğümleri sürükleyerek konumlandırma
• Manuel/Otomatik Bağlantılar: Shift+Click veya AI ile bağlantı oluşturma

🔄 Spaced Repetition

• SM-2 Algoritması: Bilimsel tekrar zamanlama
• Sürpriz Sistemi: Her oturum açılışında özel sürprizler
• Tahmin Takibi: Tahminlerinizi kaydedin, vadesi gelince yüzleşin

🎨 Modern Arayüz

• PyQt6 Tabanlı: Hızlı ve responsive UI
• Karanlık Tema: Göz dostu arayüz
• Klavye Kısayolları: Hızlı erişim için kısayollar

🚀 Kurulum

Gereksinimler

• Python 3.8 veya üzeri
• pip (Python paket yöneticisi)

Adımlar

1. Repoyu klonlayın

git clone https://github.com/yourusername/resonance.git
cd resonance

2. Bağımlılıkları yükleyin

pip install -r requirements.txt

3. API anahtarlarını ayarlayın

cp .env.example .env

.env dosyasını düzenleyip API anahtarlarınızı ekleyin:

AI_PROVIDER=nvidia  # veya gemini, veya offline

# NVIDIA NIM API (https://build.nvidia.com/)
NVIDIA_API_KEY=your_nvidia_api_key_here

# veya Google Gemini API (https://aistudio.google.com/app/apikey)
GEMINI_API_KEY=your_gemini_api_key_here

4. Uygulamayı başlatın

python main.py

🔑 API Anahtarı Alma

NVIDIA NIM (Önerilen)

1. build.nvidia.com adresine gidin
2. Ücretsiz hesap oluşturun
3. API anahtarınızı alın
4. .env dosyasına ekleyin

Google Gemini

1. Google AI Studio adresine gidin
2. API anahtarı oluşturun
3. .env dosyasına ekleyin

Offline Mod (API Gerekmez)

API anahtarı olmadan da çalışır! Ayarlar → AI → "offline" seçin.

• Yerel sentence-transformers modeli kullanır
• İnternet bağlantısı gerektirmez
• Daha yavaş ama tamamen ücretsiz

📖 Kullanım

Yeni Not Oluşturma

1. Ctrl+N veya "Yeni Not" butonuna tıklayın
2. Başlık ve içerik girin
3. Ctrl+S ile kaydedin
4. AI otomatik olarak insight card oluşturur

Graf Görünümü

1. "🗺️ Graf" sekmesine gidin
2. Notlarınızı görselleştirin
3. Shift+Click: İki nota tıklayarak bağlantı oluşturun
4. Sağ Tık: Bağlantı menüsü ve AI önerileri
5. 🤖 Otomatik Bağlantı Keşfi: Tüm notları otomatik bağla

Insight Cards

1. "💡 Insight Cards" sekmesine gidin
2. Tüm notlarınızın özet kartlarını görün
3. Güç skoruna göre sıralanmış
4. Karta tıklayarak detayları görün

Sürpriz Sistemi

• Her oturum açılışında bir sürpriz alırsınız
• Sokratik sorular, geçmiş notlar, tahmin vadesi
• Cevaplarınız insight card'ları güçlendirir

⌨️ Klavye Kısayolları

Kısayol	Eylem
Ctrl+N	Yeni not
Ctrl+S	Kaydet
Ctrl+D	Dashboard
Ctrl+R	Review
Shift+Click	Graf'ta hızlı bağlantı

🛠️ Teknoloji Stack

• Backend: Python 3.8+, SQLite (WAL mode)
• Vector DB: ChromaDB (semantik arama)
• AI: NVIDIA NIM / Google Gemini / Offline (sentence-transformers)
• UI: PyQt6
• Scheduler: APScheduler (SM-2 algoritması)

📁 Proje Yapısı

resonance/
├── ai/                    # AI modülleri
│   ├── atomization.py     # Not → atomik iddialar
│   ├── insight_card_builder.py  # Insight card oluşturma
│   ├── connection_suggester.py  # Bağlantı önerileri
│   └── socratic.py        # Sokratik sorular
├── core/                  # Temel mantık
│   ├── note_service.py    # Not yönetimi
│   ├── database.py        # SQLite wrapper
│   └── surprise_engine.py # Sürpriz sistemi
├── ui/                    # Kullanıcı arayüzü
│   ├── main_window.py     # Ana pencere
│   ├── graph_view.py      # İnteraktif graf
│   └── insight_cards_panel.py  # Insight cards UI
├── storage/               # Veri katmanı
│   ├── schema.sql         # Veritabanı şeması
│   └── vector_store.py    # ChromaDB wrapper
├── data/                  # Kullanıcı verisi (git'e eklenmez)
├── .env                   # API anahtarları (git'e eklenmez)
└── main.py               # Giriş noktası

🔒 Güvenlik

• ⚠️ API anahtarlarınızı asla paylaşmayın!
• .env dosyası .gitignore'da — commit edilmez
• data/ klasörü .gitignore'da — notlarınız gizli kalır
• Açık kaynak olarak paylaşırken .env.example kullanın

🤝 Katkıda Bulunma

Katkılar memnuniyetle karşılanır! Lütfen:

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

📝 Lisans

Bu proje MIT lisansı altında lisanslanmıştır. Detaylar için LICENSE dosyasına bakın.

🙏 Teşekkürler

• NVIDIA NIM - AI API
• Google Gemini - AI API
• ChromaDB - Vector database
• PyQt6 - UI framework

📧 İletişim

Sorularınız için issue açabilirsiniz.

---

Not: Bu uygulama kişisel not alma ve fikir geliştirme için tasarlanmıştır. Tüm verileriniz yerel olarak saklanır.