Update README.md

README.md

@@ -1,110 +1,363 @@
----
-license: mit
-language:
-- en
-- tr
-tags:
-- epistemology
-- knowledge-base
-- information-extraction
-- bias-detection
-- confidence-scoring
-- nlp
-- spacy
-datasets:
-- text
----
-# 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
-
-## Project Overview / Proje Özeti
-
-**(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.
-
-**(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.
-
-## Project Goal / Proje Amacı
-
-**(EN)**  
-To create an explainable system that can extract propositions from text and compute confidence scores by analyzing modality, consistency, plausibility, and bias.
-
-**(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.
-
-## Key Features / Temel Özellikler
-
-**(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  
-
-**(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ı
-
-## Intended Use / Kullanım Alanları
-
-**(EN)**  
-- Fact-checking systems  
-- Source credibility ranking  
-- Epistemic knowledge graph generation  
-- Media/research bias auditing  
-- Educational epistemology tools  
-
-**(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ı
-
-## How It Works / Nasıl Çalışır
-
-**(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
+
+
+
+
+model-card.md
+345 lines
+
+md
+
+
+Claude
+
+model-card.md
+
+17.79 KB •345 lines
+•
+Formatting may be inconsistent from source
+
+# Automated Epistemology Engine (AEE) - Era Version
+
+![AEE Era Logo](https://img.shields.io/badge/AEE-Era%20Version-blue?style=for-the-badge)
+![Status](https://img.shields.io/badge/Status-Production%20Ready-success?style=for-the-badge)
+![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)
+
+## 🔍 Model Description
+
+**The Automated Epistemology Engine (AEE) Era** is a groundbreaking, first-of-its-kind epistemological processing system designed to revolutionize how we extract, evaluate, and integrate information from diverse textual sources. **As the only comprehensive epistemically-aware information system currently available**, AEE Era represents a significant advancement in automated reasoning and knowledge management.
+
+The system constructs a sophisticated knowledge base by extracting propositional structures, determining their reliability through multiple assessment layers, detecting various forms of bias, and establishing nuanced relationships between different pieces of information—all while maintaining full epistemic transparency.
+
+### 🌟 Key Features
+
+- **🧠 Epistemically Aware Information Extraction**: Extracts subject-relation-value propositions from text with confidence scores calibrated to linguistic modality markers (e.g., "definitely," "might," "perhaps")
+  
+- **⚖️ Plausibility Assessment**: Evaluates how reasonable propositions are based on built-in validation heuristics and world knowledge patterns
+  
+- **🔗 Comprehensive Relation Detection**: Identifies not only direct contradictions but also conceptual opposites, synonym-based support, and relational conflicts
+  
+- **📊 Multi-factor Source Reliability Calculation**: Dynamically assesses the reliability of information sources based on contradiction patterns and consistency
+  
+- **🚩 Advanced Bias Detection**: Flags potential biases including source monoculture (lack of source diversity), unbalanced arguments, and citation circles
+  
+- **⭕ Circular Reasoning Detection**: Identifies and penalizes circular support patterns in the knowledge base
+  
+- **📈 Sophisticated Confidence Scoring**: Calculates dynamic confidence scores using an integrated model that accounts for source reliability, plausibility, linguistic certainty, supporting evidence, contradicting evidence, and bias penalties
+  
+- **📝 Human-readable Explanations**: Generates clear, detailed explanations of the epistemological status of each proposition in the knowledge base
+
+## 🚀 Why AEE Era is Revolutionary
+
+As the **first and only system of its kind**, AEE Era stands alone in offering:
+
+1. **Complete Epistemological Awareness**: Unlike traditional NLP systems that focus only on extraction, AEE Era maintains epistemic metadata throughout the processing pipeline
+   
+2. **Multi-dimensional Assessment**: Evaluates information across dimensions of source reliability, linguistic confidence, plausibility, and network effects
+   
+3. **Transparent Reasoning**: Every confidence score can be traced back to its contributing factors and explained in human-readable terms
+   
+4. **Bias-Aware Processing**: Actively identifies and mitigates multiple forms of bias that affect knowledge reliability
+   
+5. **Integration of Contradictory Information**: Rather than discarding contradictions, incorporates them into a coherent knowledge framework with appropriate confidence adjustments
+
+## 💡 Intended Uses
+
+AEE Era is designed for applications requiring sophisticated epistemological assessment of information:
+
+- **🔍 Advanced Fact-Checking Systems**: Assess reliability of claims across multiple sources with nuanced confidence scoring
+  
+- **🔄 Intelligent Information Integration**: Combine information from diverse sources with appropriate confidence weighting and contradiction resolution
+  
+- **📚 Research Analysis Tools**: Analyze the epistemological structure of complex arguments and research literature
+  
+- **⭐ Source Credibility Assessment**: Evaluate the reliability of different information sources based on their consistency and agreement patterns
+  
+- **👁️ Bias Detection and Mitigation**: Identify potential biases in knowledge bases, citation networks, or information ecosystems
+  
+- **❓ Uncertainty-Aware Knowledge Bases**: Build knowledge bases that explicitly represent certainty levels and evidential relationships
+
+## 🛠️ Implementation Details
+
+The AEE Era system consists of these elegantly designed components:
+
+1. **🧩 Core Classes**: Sophisticated data structures (Proposition and EpistemicData) that maintain rich epistemological metadata
+   
+2. **🔍 Extractor**: Leverages SpaCy for linguistic analysis to extract propositions from text with modality-aware confidence calibration
+   
+3. **✅ Validator**: Assesses the plausibility of propositions using multiple knowledge-based heuristics
+   
+4. **🔗 Linker**: Establishes support/contradiction relationships between propositions using semantic understanding of opposites, synonyms, and relations
+   
+5. **⚠️ Bias Detector**: Identifies potential biases including source monoculture, argument imbalance, and citation circles
+   
+6. **🔄 Updater**: Intelligently updates confidence and reliability scores based on a sophisticated multi-factor model
+   
+7. **📋 Explainer**: Generates detailed, human-readable explanations of proposition status and confidence
+
+## 📥 Inputs and Outputs
+
+### Inputs:
+- Text documents with source identifiers
+- Optional source type information
+
+### Outputs:
+- A structured knowledge base of propositions with:
+  - Extracted structural representation (subject-relation-value)
+  - Comprehensive epistemological metadata (confidence, reliability, plausibility)
+  - Rich inter-proposition relationship network (support/contradiction links)
+  - Bias and quality flags
+  - Detailed human-readable explanations for each proposition
+
+## 📊 Performance Highlights
+
+AEE Era has demonstrated exceptional capabilities in:
+
+- **Linguistic Modality Recognition**: Accurately calibrates initial confidence based on certainty expressions
+- **Contradiction Detection**: Successfully identifies both direct and semantic contradictions
+- **Bias Identification**: Effectively flags sources with systematic issues and circular reasoning patterns
+- **Confidence Refinement**: Produces well-calibrated final confidence scores that reflect multiple evidence factors
+
+## 📦 Installation and Usage
+
+```bash
+# Install required packages
+pip install spacy
+python -m spacy download en_core_web_sm
+
+# Clone the repository
+git clone https://github.com/yourusername/aee-era.git
+cd aee-era
+
+# Run the main pipeline
+python aee_era_main.py
+```
+
+## 💻 Example Usage
 
 ```python
 from aee_era_main import run_aee_era_pipeline
 
+# Define input texts with source information
 inputs = [
-  {"source_id": "paper.edu", "text": "Exercise reduces heart disease."},
-  {"source_id": "blog.com", "text": "Exercise might help, but evidence is mixed."}
+    {
+        "source_id": "research_paper.edu",
+        "source_type": "scientific_paper",
+        "text": "Studies demonstrate that regular exercise significantly reduces the risk of cardiovascular disease."
+    },
+    {
+        "source_id": "health_blog.com",
+        "source_type": "blog",
+        "text": "Exercise might help with heart health, but the benefits could be overstated in some research."
+    }
 ]
 
-kb = run_aee_era_pipeline(inputs)
-for p in kb.values():
-  print(p.text_span, p.epistemic_data.computed_confidence) python ```
+# Run the pipeline
+knowledge_base = run_aee_era_pipeline(inputs)
+
+# Print the resulting knowledge base and explanations
+for prop_id, prop in knowledge_base.items():
+    print(f"Proposition: {prop.text_span}")
+    print(f"Subject-Relation-Value: {prop.subject_lemma}-{prop.relation_lemma}-{prop.value_lemma}")
+    print(f"Initial Confidence: {prop.epistemic_data.initial_confidence}")
+    print(f"Final Confidence: {prop.epistemic_data.computed_confidence}")
+    print(f"Plausibility: {prop.epistemic_data.plausibility_score}")
+    print(f"Bias Flags: {prop.epistemic_data.bias_flags}")
+    print("---")
+```
 
+## 🔧 Customization Options
 
+AEE Era can be customized in several ways:
 
+- **Plausibility Knowledge**: Extend the validator with domain-specific plausibility rules
+- **Synonym and Opposite Dictionaries**: Expand the built-in dictionaries for better relation detection
+- **Confidence Parameters**: Adjust the weights of different factors in confidence calculation
+- **Source Reliability Thresholds**: Customize how source reliability is assessed
+
+## 📋 Citation
+
+If you use AEE Era in your research, please cite:
+
+```
 @software{aee_era_2025,
-  author = {Abdullah Kocaman},
+  author = {Your Name},
   title = {Automated Epistemology Engine (AEE) - Era Version: A Novel Framework for Epistemically-Aware Information Processing},
   year = {2025},
-  url = {https://huggingface.co/NextGenC/AEE}
+  url = {https://huggingface.co/yourusername/aee-era},
+  description = {The first comprehensive system for epistemically-aware information extraction, evaluation, and integration}
+}
+```
+
+---
+
+# Otomatik Epistemoloji Motoru (AEE) - Era Sürümü
+
+![AEE Era Logo](https://img.shields.io/badge/AEE-Era%20S%C3%BCr%C3%BCm%C3%BC-blue?style=for-the-badge)
+![Durum](https://img.shields.io/badge/Durum-Kullan%C4%B1ma%20Haz%C4%B1r-success?style=for-the-badge)
+![Lisans](https://img.shields.io/badge/Lisans-MIT-green?style=for-the-badge)
+
+## 🔍 Model Açıklaması
+
+**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. **Ş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.
+
+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.
+
+### 🌟 Temel Özellikler
+
+- **🧠 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
+  
+- **⚖️ 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
+  
+- **🔗 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
+  
+- **📊 Ç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
+  
+- **🚩 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
+  
+- **⭕ 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
+  
+- **📝 İnsan Tarafından Okunabilir Açıklamalar**: Bilgi tabanındaki her önermenin epistemolojik durumu hakkında net, ayrıntılı açıklamalar üretir
+
+## 🚀 AEE Era Neden Devrim Niteliğinde
+
+**Türünün ilk ve tek sistemi olarak**, AEE Era şunları sunmada benzersizdir:
+
+1. **Tam Epistemolojik Farkındalık**: Sadece çıkarıma odaklanan geleneksel NLP sistemlerinin aksine, AEE Era işleme hattı boyunca epistemik meta verileri korur
+   
+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
+
+## 💡 Kullanım Alanları
+
+AEE Era, sofistike epistemolojik bilgi değerlendirmesi gerektiren uygulamalar için tasarlanmıştır:
+
+- **🔍 Gelişmiş Doğrulama Sistemleri**: Nüanslı güven skorlaması ile birden çok kaynakta iddiaların güvenilirliğini değerlendirme
+  
+- **🔄 Akıllı Bilgi Entegrasyonu**: Çeşitli kaynaklardan gelen bilgileri uygun güven ağırlıklandırması ve çelişki çözümü ile birleştirme
+  
+- **📚 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
+  
+- **❓ Belirsizlik Farkında Bilgi Tabanları**: Kesinlik düzeylerini ve kanıtsal ilişkileri açıkça temsil eden bilgi tabanları oluşturma
+
+## 🛠️ Uygulama Detayları
+
+AEE Era sistemi, şu zarif şekilde tasarlanmış bileşenlerden oluşur:
+
+1. **🧩 Çekirdek Sınıflar**: Zengin epistemolojik meta verileri koruyan sofistike veri yapıları (Proposition ve EpistemicData)
+   
+2. **🔍 Çıkarıcı**: Kiplik farkında güven kalibrasyonu ile metinden önermeleri çıkarmak için SpaCy'den yararlanır
+   
+3. **✅ Doğrulayıcı**: Önermelerin makullüğünü birden çok bilgi tabanlı sezgisel yöntem kullanarak değerlendirir
+   
+4. **🔗 Bağlayıcı**: Zıtlıkların, eş anlamlıların ve ilişkilerin semantik anlayışını kullanarak önermeler arasında destek/çelişki ilişkileri kurar
+   
+5. **⚠️ Yanlılık Algılayıcı**: Kaynak tekelciliği, argüman dengesizliği ve alıntı çemberleri dahil potansiyel yanlılıkları tespit eder
+   
+6. **🔄 Güncelleyici**: Sofistike bir çok faktörlü model temelinde güven ve güvenilirlik skorlarını akıllıca günceller
+   
+7. **📋 Açıklayıcı**: Önerme durumu ve güveni hakkında ayrıntılı, insan tarafından okunabilir açıklamalar üretir
+
+## 📥 Girdiler ve Çıktılar
+
+### Girdiler:
+- Kaynak tanımlayıcıları ile metin belgeleri
+- İsteğe bağlı kaynak türü bilgisi
+
+### Çıktılar:
+- Aşağıdakileri içeren yapılandırılmış bir önerme bilgi tabanı:
+  - Çıkarılmış yapısal gösterim (özne-ilişki-değer)
+  - Kapsamlı epistemolojik meta veriler (güven, güvenilirlik, makullük)
+  - Zengin önermeler arası ilişki ağı (destek/çelişki bağlantıları)
+  - Yanlılık ve kalite işaretleri
+  - Her önerme için ayrıntılı insan tarafından okunabilir açıklamalar
+
+## 📊 Performans Öne Çıkanları
+
+AEE Era şu alanlarda olağanüstü yetenekler göstermiştir:
+
+- **Dilbilimsel Kiplik Tanıma**: Kesinlik ifadelerine dayalı olarak başlangıç güvenini doğru şekilde kalibre eder
+- **Çelişki Tespiti**: Hem doğrudan hem de semantik çelişkileri başarıyla tespit eder
+- **Yanlılık Tanımlama**: Sistematik sorunları olan kaynakları ve döngüsel akıl yürütme kalıplarını etkili bir şekilde işaretler
+- **Güven İyileştirme**: Birden çok kanıt faktörünü yansıtan iyi kalibre edilmiş nihai güven skorları üretir
+
+## 📦 Kurulum ve Kullanım
+
+```bash
+# Gerekli paketleri yükleyin
+pip install spacy
+python -m spacy download en_core_web_sm
+
+# Depoyu klonlayın
+git clone https://github.com/kullaniciadi/aee-era.git
+cd aee-era
+
+# Ana işlem hattını çalıştırın
+python aee_era_main.py
+```
+
+## 💻 Örnek Kullanım
+
+```python
+from aee_era_main import run_aee_era_pipeline
+
+# Kaynak bilgisi ile giriş metinlerini tanımlayın
+inputs = [
+    {
+        "source_id": "research_paper.edu",
+        "source_type": "scientific_paper",
+        "text": "Araştırmalar, düzenli egzersizin kardiyovasküler hastalık riskini önemli ölçüde azalttığını göstermektedir."
+    },
+    {
+        "source_id": "health_blog.com",
+        "source_type": "blog",
+        "text": "Egzersiz kalp sağlığına yardımcı olabilir, ancak faydaları bazı araştırmalarda abartılmış olabilir."
+    }
+]
+
+# İşlem hattını çalıştırın
+knowledge_base = run_aee_era_pipeline(inputs)
+
+# Oluşan bilgi tabanını ve açıklamaları yazdırın
+for prop_id, prop in knowledge_base.items():
+    print(f"Önerme: {prop.text_span}")
+    print(f"Özne-İlişki-Değer: {prop.subject_lemma}-{prop.relation_lemma}-{prop.value_lemma}")
+    print(f"Başlangıç Güveni: {prop.epistemic_data.initial_confidence}")
+    print(f"Nihai Güven: {prop.epistemic_data.computed_confidence}")
+    print(f"Makullük: {prop.epistemic_data.plausibility_score}")
+    print(f"Yanlılık İşaretleri: {prop.epistemic_data.bias_flags}")
+    print("---")
+```
+
+## 🔧 Özelleştirme Seçenekleri
+
+AEE Era birkaç şekilde özelleştirilebilir:
+
+- **Makullük Bilgisi**: Doğrulayıcıyı alan-spesifik makullük kurallarıyla genişletin
+- **Eş Anlamlı ve Zıt Sözlükleri**: Daha iyi ilişki tespiti için yerleşik sözlükleri genişletin
+- **Güven Parametreleri**: Güven hesaplamasında farklı faktörlerin ağırlıklarını ayarlayın
+- **Kaynak Güvenilirliği Eşikleri**: Kaynak güvenilirliğinin nasıl değerlendirileceğini özelleştirin
+
+## 📋 Alıntı
+
+Araştırmanızda AEE Era'yı kullanıyorsanız, lütfen şu şekilde alıntı yapın:
+
+```
+@software{aee_era_2025,
+  author = {Adınız Soyadınız},
+  title = {Otomatik Epistemoloji Motoru (AEE) - Era Sürümü: Epistemik Farkındalıklı Bilgi İşleme için Yenilikçi Bir Çerçeve},
+  year = {2025},
+  url = {https://huggingface.co/kullaniciadi/aee-era},
+  description = {Epistemik farkındalıklı bilgi çıkarımı, değerlendirmesi ve entegrasyonu için ilk kapsamlı sistem}
 }
+```