Update README.md

README.md

@@ -1,80 +1,135 @@
 ---
-license: apache-2.0 # VEYA UYGUN LİSANSI BELİRTİN
+license: mit
 language:
-- tr
 - en
+- tr
 tags:
 - epistemology
-- information extraction
-- knowledge base
-- bias detection
-- source reliability
+- knowledge-base
+- information-extraction
+- bias-detection
+- confidence-scoring
 - nlp
 - spacy
-pipeline_tag: text-classification # VEYA EN UYGUN ETİKETİ SEÇİN
-widget:
-- text: "Kaynak 1: Bilimsel makalelere göre düzenli egzersiz kalp hastalıkları riskini kesinlikle azaltır. Kaynak 2: Bir sağlık bloguna göre egzersiz kalp sağlığına yardımcı olabilir ancak faydaları abartılıyor olabilir."
+datasets:
+- text
 ---
 
-# Otomatik Epistemoloji Motoru (AEE) - Era Sürümü
+# (EN) This project belongs to an 18-year-old software developer.  
+# (TR) Bu proje 18 yaşındaki bir yazılımcıya aittir.
 
-## Model Açıklaması
+# Automated Epistemology Engine (AEE) - Era Version  
+# Epistemic Reasoning & Bias-Aware Information Integration  
+# Epistemik Akıl Yürütme ve Yanlılık Farkındalıklı Bilgi Entegrasyonu
 
-[Otomatik Epistemoloji Motoru (AEE) Era, çeşitli metin kaynaklarından bilgileri çıkarma, değerlendirme ve entegre etme şeklimizi devrimselleştirmek için tasarlanmış, türünün ilk örneği olan çığır açıcı bir epistemolojik işleme sistemidir.] ([source: 15, 17]) [Şu anda mevcut olan tek kapsamlı epistemik farkındalığa sahip bilgi sistemi olarak, AEE Era, otomatik akıl yürütme ve bilgi yönetiminde önemli bir ilerlemeyi temsil eder.] ([source: 16]) [Sistem, önerme yapılarını çıkararak, bunların güvenilirliğini çoklu değerlendirme katmanları aracılığıyla belirleyerek, çeşitli yanlılık biçimlerini tespit ederek ve farklı bilgi parçaları arasında nüanslı ilişkiler kurarak -tüm bunları tam epistemik şeffaflık içinde sürdürerek- sofistike bir bilgi tabanı oluşturur.] ([source: 17])
+## Project Overview / Proje Özeti
 
-### Temel Özellikler
+**(EN)**  
+The Automated Epistemology Engine (AEE) - Era is a first-of-its-kind system for structured, confidence-scored, and bias-aware extraction of knowledge from text. It builds a traceable knowledge base integrating modality, contradiction, source metadata, and heuristics.
 
-* [**Epistemik Farkındalığa Sahip Bilgi Çıkarımı:** Dilbilimsel kiplik belirteçlerine (örn. "kesinlikle," "belki," "muhtemelen") göre kalibre edilmiş güven skorlarıyla metinden özne-ilişki-değer önermelerini çıkarır.] ([source: 19])
-* [**Makullük Değerlendirmesi:** Önermelerin ne kadar makul olduğunu yerleşik doğrulama sezgileri ve dünya bilgisi kalıplarına dayanarak değerlendirir.] ([source: 19])
-* [**Kapsamlı İlişki Tespiti:** Sadece doğrudan çelişkileri değil, aynı zamanda kavramsal zıtlıkları, eş anlamlılara dayalı desteği ve ilişkisel çatışmaları da tespit eder.] ([source: 19])
-* [**Çok Faktörlü Kaynak Güvenilirliği Hesaplaması:** Çelişki kalıpları ve tutarlılığa dayalı olarak bilgi kaynaklarının güvenilirliğini dinamik olarak değerlendirir.] ([source: 5])
-* [**Gelişmiş Yanlılık Tespiti:** Kaynak tekelciliği (kaynak çeşitliliği eksikliği), dengesiz argümanlar ve alıntı çemberleri dahil potansiyel yanlılıkları işaretler.] ([source: 5])
-* **Döngüsel Akıl Yürütme Tespiti:** Bilgi tabanındaki döngüsel destek kalıplarını tespit eder ve cezalandırır.
-* [**Sofistike Güven Skorlaması:** Kaynak güvenilirliği, makullük, dilbilimsel kesinlik, destekleyici kanıt, çelişen kanıt ve yanlılık cezalarını hesaba katan entegre bir model kullanarak dinamik güven skorları hesaplar.] ([source: 20])
-* [**İnsan Tarafından Okunabilir Açıklamalar:** Bilgi tabanındaki her önermenin epistemolojik durumu hakkında net, ayrıntılı açıklamalar üretir.] ([source: 21])
+**(TR)**  
+Otomatik Epistemoloji Motoru (AEE) - Era, metinlerden yapılandırılmış, güven skorlamalı ve yanlılık farkındalıklı bilgi çıkarımı sağlayan bir sistemdir. Dil kiplikleri, çelişki ilişkileri, kaynak metaverisi ve sezgilere dayalı izlenebilir bir bilgi tabanı oluşturur.
 
-### AEE Era Neden Devrim Niteliğinde
+## Project Goal / Proje Amacı
 
-Türünün ilk ve tek sistemi olarak, AEE Era şunları sunmada benzersizdir:
+**(EN)**  
+To create an explainable system that can extract propositions from text and compute confidence scores by analyzing modality, consistency, plausibility, and bias.
 
-1.  [**Tam Epistemolojik Farkındalık:** Sadece çıkarıma odaklanan geleneksel NLP sistemlerinin aksine, AEE Era işleme hattı boyunca epistemik meta verileri korur.] ([source: 6])
-2.  **Çok Boyutlu Değerlendirme:** Bilgiyi kaynak güvenilirliği, dilbilimsel güven, makullük ve ağ etkileri boyutları açısından değerlendirir.
-3.  **Şeffaf Akıl Yürütme:** Her güven skoru, katkıda bulunan faktörlerine kadar izlenebilir ve insan tarafından okunabilir terimlerle açıklanabilir.
-4.  **Yanlılık Farkında İşleme:** Bilgi güvenilirliğini etkileyen birden çok yanlılık biçimini aktif olarak tanımlar ve azaltır.
-5.  [**Çelişkili Bilgilerin Entegrasyonu:** Çelişkileri atmak yerine, onları uygun güven ayarlamalarıyla tutarlı bir bilgi çerçevesine dahil eder.] ([source: 22])
+**(TR)**  
+Metinden önermeler çıkaran, kiplik, tutarlılık, makullük ve yanlılık analizleriyle güven skoru hesaplayan açıklanabilir bir sistem inşa etmek.
 
-## Kullanım Alanları
+## Key Features / Temel Özellikler
 
-AEE Era, sofistike epistemolojik bilgi değerlendirmesi gerektiren uygulamalar için tasarlanmıştır:
+**(EN)**  
+- Modality-based confidence estimation  
+- Plausibility heuristics for propositions  
+- Contradiction/support/synonym detection  
+- Source reliability estimation  
+- Bias detection: monoculture, citation loops, imbalance  
+- Transparent confidence explanations  
 
-* [**Gelişmiş Doğrulama Sistemleri:** Nüanslı güven skorlaması ile birden çok kaynakta iddiaların güvenilirliğini değerlendirme.] ([source: 7])
-* [**Akıllı Bilgi Entegrasyonu:** Çeşitli kaynaklardan gelen bilgileri uygun güven ağırlıklandırması ve çelişki çözümü ile birleştirme.] ([source: 23])
-* **Araştırma Analiz Araçları:** Karmaşık argümanların ve araştırma literatürünün epistemolojik yapısını analiz etme.
-* **Kaynak Güvenilirliği Değerlendirmesi:** Farklı bilgi kaynaklarının tutarlılık ve anlaşma kalıplarına dayalı olarak güvenilirliğini değerlendirme.
-* [**Yanlılık Tespiti ve Azaltma:** Bilgi tabanlarında, alıntı ağlarında veya bilgi ekosistemlerinde potansiyel yanlılıkları tespit etme.] ([source: 8])
-* [**Belirsizlik Farkında Bilgi Tabanları:** Kesinlik düzeylerini ve kanıtsal ilişkileri açıkça temsil eden bilgi tabanları oluşturma.] ([source: 9, 24])
+**(TR)**  
+- Kiplik temelli güven tahmini  
+- Önermeler için makullük sezgileri  
+- Çelişki/destek/eş anlam ilişkileri  
+- Kaynak güvenilirliği değerlendirmesi  
+- Yanlılık tespiti: kaynak tekelciliği, alıntı döngüleri, dengesizlik  
+- Açıklanabilir güven skorlaması
 
-## Riskler ve Sınırlamalar
+## Intended Use / Kullanım Alanları
 
-* Modelin performansı, girdi metinlerinin kalitesine ve SpaCy modelinin doğruluğuna bağlıdır.
-* Yanlılık tespiti özellikleri kapsamlı olsa da, her türlü örtük yanlılığı tespit edemeyebilir.
-* Makullük değerlendirmesi, yerleşik sezgilere ve bilgi kalıplarına dayanır ve alan-spesifik bilgilerle genişletilmediğinde sınırlı olabilir.
-* Karmaşık veya belirsiz dil yapıları, önerme çıkarımında hatalara yol açabilir.
+**(EN)**  
+- Fact-checking systems  
+- Source credibility ranking  
+- Epistemic knowledge graph generation  
+- Media/research bias auditing  
+- Educational epistemology tools  
 
-## Nasıl Başlanır
+**(TR)**  
+- Doğruluk kontrol sistemleri  
+- Kaynak güvenilirliği sıralaması  
+- Epistemik bilgi grafikleri oluşturma  
+- Medya/akademik yanlılık denetimi  
+- Eğitimde epistemoloji araçları
 
-### Kurulum
+## How It Works / Nasıl Çalışır
 
-```bash
-# Gerekli paketleri yükleyin
-pip install spacy
+**(EN)**  
+1. Extractor: Linguistic parser using SpaCy  
+2. Validator: Rule-based plausibility checking  
+3. Linker: Detects semantic contradiction/support  
+4. Bias Detector: Analyzes structural bias patterns  
+5. Confidence Updater: Combines factors into scores  
+6. Explainer: Generates human-readable insights  
+
+**(TR)**  
+1. Çıkarıcı: SpaCy tabanlı dil ayrıştırıcı  
+2. Doğrulayıcı: Kural temelli makullük kontrolü  
+3. Bağlayıcı: Anlamsal çelişki/destek tespiti  
+4. Yanlılık Algılayıcı: Yapısal yanlılık örüntüleri  
+5. Güven Güncelleyici: Faktörleri skora çevirir  
+6. Açıklayıcı: İnsan tarafından okunabilir içgörüler üretir
+
+## Example Usage / Örnek Kullanım
 
-# Gerekli SpaCy modelini indirin
-python -m spacy download en_core_web_sm # VEYA Türkçe için tr_core_news_sm
+```python
+from aee_era_main import run_aee_era_pipeline
 
-# Depoyu klonlayın (Depo URL'sini güncelleyin)
-git clone [https://github.com/kullaniciadi/aee-era.git](https://github.com/kullaniciadi/aee-era.git)
+inputs = [
+  {"source_id": "paper.edu", "text": "Exercise reduces heart disease."},
+  {"source_id": "blog.com", "text": "Exercise might help, but evidence is mixed."}
+]
+
+kb = run_aee_era_pipeline(inputs)
+for p in kb.values():
+  print(p.text_span, p.epistemic_data.computed_confidence)
+
+## Installation / Kurulum
+pip install spacy
+python -m spacy download en_core_web_sm
+git clone https://github.com/yourusername/aee-era.git
 cd aee-era
+python aee_era_main.py
+
+## Limitations / Sınırlamalar
+**(EN)**
+
+-English only; Turkish is experimental
+
+-SpaCy dependency
+
+-Uses heuristics, no deep learning yet
+
+-Source-type detection is pattern-based
+
+**(TR)**
+
+-Yalnızca İngilizce optimize; Türkçe deneyseldir
+
+-SpaCy bağımlıdır
+
+-Heuristiklere dayalıdır, henüz derin öğrenme yok
+
+-Kaynak türü çıkarımı şablon bazlıdır
+
 
-# Ana işlem hattını çalıştırın
-python aee_era_main.py