syscred 2.2.0__py3-none-any.whl

syscred-2.2.0.dist-info/METADATA

@@ -0,0 +1,259 @@
+Metadata-Version: 2.4
+Name: syscred
+Version: 2.2.0
+Summary: A Neuro-Symbolic AI System for Information Credibility Verification
+Author-email: "Dominique S. Loyer" <loyer.dominique@uqam.ca>
+Project-URL: Homepage, https://github.com/DominiqueLoyer/systemFactChecking
+Project-URL: Repository, https://github.com/DominiqueLoyer/systemFactChecking
+Project-URL: Documentation, https://github.com/DominiqueLoyer/systemFactChecking/tree/main/03_Docs
+Project-URL: Bug Tracker, https://github.com/DominiqueLoyer/systemFactChecking/issues
+Project-URL: Zenodo, https://doi.org/10.5281/zenodo.17943226
+Project-URL: Sponsor, https://github.com/sponsors/DominiqueLoyer
+Keywords: fact-checking,credibility,information-verification,neuro-symbolic-ai,ontology,nlp,explainable-ai
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Requires-Dist: beautifulsoup4>=4.11.0
+Requires-Dist: python-whois>=0.8.0
+Requires-Dist: rdflib>=6.0.0
+Requires-Dist: flask>=2.3.0
+Requires-Dist: flask-cors>=4.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pandas>=2.0.0
+Provides-Extra: ml
+Requires-Dist: torch>=2.0.0; extra == "ml"
+Requires-Dist: transformers>=4.30.0; extra == "ml"
+Requires-Dist: sentence-transformers>=2.2.0; extra == "ml"
+Requires-Dist: numpy>=1.24.0; extra == "ml"
+Requires-Dist: lime>=0.2.0; extra == "ml"
+Provides-Extra: production
+Requires-Dist: gunicorn>=20.1.0; extra == "production"
+Requires-Dist: psycopg2-binary>=2.9.0; extra == "production"
+Requires-Dist: flask-sqlalchemy>=3.0.0; extra == "production"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: syscred[ml]; extra == "all"
+Requires-Dist: syscred[production]; extra == "all"
+Requires-Dist: syscred[dev]; extra == "all"
+Dynamic: license-file
+
+# Fact Checking System: Information Credibility Verification
+
+<!-- [![DOI](https://zenodo.org/badge/992891582.svg)](https://zenodo.org/badge/latestdoi/992891582) -->
+[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DominiqueLoyer/systemFactChecking/blob/main/02_Code/v2_syscred/syscred_colab.ipynb)
+[![Kaggle](https://kaggle.com/static/images/open-in-kaggle.svg)](https://kaggle.com/kernels/welcome?src=https://github.com/DominiqueLoyer/systemFactChecking/blob/main/02_Code/v2_syscred/syscred_kaggle.ipynb)
+[![Buy me a coffee](https://img.shields.io/badge/Buy%20me%20a%20coffee-FFDD00?logo=buy-me-a-coffee&logoColor=black)](https://www.buymeacoffee.com/dominiqueloyer)
+[![Sponsor on GitHub](https://img.shields.io/badge/Sponsor-DominiqueLoyer-EA4AAA?logo=github-sponsors)](https://github.com/sponsors/DominiqueLoyer)
+
+**PhD Thesis Prototype** - Dominique S. Loyer  
+*Citation Key: loyerModelingHybridSystem2025*
+
+> [!NOTE]
+> **New in v2.2 (Jan 29, 2026)**:
+> - **GraphRAG**: Contextual memory from Knowledge Graph.
+> - **Interactive Graph**: D3.js visualization with physics and details on click.
+> - **Cloud Ready**: Docker & Supabase integration.
+
+---
+
+## 📋 Overview
+
+A **neuro-symbolic AI system** for verifying information credibility that combines:
+
+- **Symbolic AI**: Rule-based reasoning with OWL ontologies (RDF/Turtle)
+- **Neural AI**: Transformer models for sentiment analysis and NER
+- **IR Engine**: BM25, TF-IDF, and PageRank estimation
+
+The system provides explainable credibility scores (High/Medium/Low) with detailed factor breakdown.
+
+---
+
+## 🚀 Quick Start (v2.0 - January 2026)
+
+### Option 1: Run on Kaggle/Colab (Recommended)
+
+1. Click the **Kaggle** or **Colab** badge above
+2. Enable GPU runtime
+3. Run All cells
+
+### Option 2: Local Installation (Docker / Recommended)
+
+```bash
+# Clone the repository
+git clone https://github.com/DominiqueLoyer/systemFactChecking.git
+cd systemFactChecking/02_Code
+
+# Run with Startup Script (Mac/Linux)
+./start_syscred.sh
+# Access at http://localhost:5001
+```
+
+### Option 3: Manual Python Run
+
+```bash
+cd systemFactChecking/02_Code
+pip install -r syscred/requirements.txt
+python syscred/backend_app.py
+```
+
+### Option 3: Python API
+
+```python
+from v2_syscred.verification_system import CredibilityVerificationSystem
+
+# Initialize
+system = CredibilityVerificationSystem()
+
+# Verify a URL
+result = system.verify_information("https://www.lemonde.fr/article")
+print(f"Score: {result['scoreCredibilite']} ({result['niveauCredibilite']})")
+
+# Verify text directly
+result = system.verify_information(
+    "According to Harvard researchers, the new study shows significant results."
+)
+```
+
+---
+
+## 📡 REST API Endpoints
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/api/verify` | POST | Full credibility verification |
+| `/api/seo` | POST | SEO analysis only (faster) |
+| `/api/ontology/stats` | GET | Ontology statistics |
+| `/api/health` | GET | Server health check |
+
+### Example Request
+
+```bash
+curl -X POST http://localhost:5000/api/verify \
+  -H "Content-Type: application/json" \
+  -d '{"input_data": "https://www.bbc.com/news/article"}'
+```
+
+### Example Response
+
+```json
+{
+  "scoreCredibilite": 0.78,
+  "niveauCredibilite": "HIGH",
+  "analysisDetails": {
+    "sourceReputation": "High",
+    "domainAge": 9125,
+    "sentiment": {"label": "NEUTRAL", "score": 0.52},
+    "entities": [{"word": "BBC", "entity_group": "ORG"}]
+  }
+}
+```
+
+---
+
+## 📁 Project Structure
+
+systemFactChecking/
+├── README.md                    # This file
+├── 01_Presentations/            # Presentations (.pdf, .tex)
+├── 02_Code/                     # Source Code & Docker
+│   ├── syscred/                 # ⭐ CORE ENGINE (v2.2)
+│   │   ├── graph_rag.py         # [NEW] GraphRAG Module
+│   │   ├── verification_system.py
+│   │   ├── database.py          # [NEW] Supabase Connector
+│   │   └── ...
+│   ├── start_syscred.sh         # Startup Script
+│   ├── Dockerfile               # Deployment Config
+│   └── requirements.txt
+├── 03_Docs/                     # Documentation (.pdf)
+└── 04_Bibliography/             # References (.bib, .pdf)
+```
+
+---
+
+## 🔧 Configuration
+
+Set environment variables or edit `02_Code/v2_syscred/config.py`:
+
+```bash
+# Optional: Google Fact Check API key
+export SYSCRED_GOOGLE_API_KEY=your_key_here
+
+# Server settings
+export SYSCRED_PORT=5000
+export SYSCRED_DEBUG=true
+export SYSCRED_ENV=production  # or development, testing
+```
+
+---
+
+## 📊 Credibility Scoring
+
+The system uses weighted factors to calculate credibility:
+
+| Factor | Weight | Description |
+|--------|--------|-------------|
+| Source Reputation | 25% | Known credible sources database |
+| Domain Age | 10% | WHOIS lookup for domain history |
+| Sentiment Neutrality | 15% | Extreme sentiment = lower score |
+| Entity Presence | 15% | Named entities (ORG, PER) |
+| Text Coherence | 15% | Vocabulary diversity |
+| Fact Check | 20% | Google Fact Check API results |
+
+**Thresholds:**
+
+- **HIGH**: Score ≥ 0.7
+- **MEDIUM**: 0.4 ≤ Score < 0.7
+- **LOW**: Score < 0.4
+
+---
+
+## 📚 Documentation & Papers
+
+- [Modeling and Hybrid System for Verification of Sources Credibility (PDF)](03_Docs/Modeling%20and%20Hybrid%20System%20for%20Verification%20of%20sources%20credibility.pdf)
+- [Ontology of a Verification System (PDF)](03_Docs/Ontology_of_a_verification_system_for_liability_of_the_information_may15_2025.pdf)
+- [Beamer Presentation - DIC9335 (PDF)](01_Presentations/syscred_presentation.pdf)
+
+---
+
+## 🏷️ Citation
+
+```bibtex
+@software{loyer2025syscred,
+  author = {Loyer, Dominique S.},
+  title = {SysCRED: Neuro-Symbolic System for Information Credibility Verification},
+  year = {2025},
+  publisher = {GitHub},
+  url = {https://github.com/DominiqueLoyer/systemFactChecking}
+}
+```
+
+---
+
+## 📜 License
+
+MIT License - See [LICENSE](LICENSE) for details.
+
+---
+
+## 🔄 Version History
+
+| Version | Date | Changes |
+|---------|------|---------|
+| v2.0 | Jan 2026 | Complete rewrite with modular architecture, Kaggle/Colab support, REST API |
+| v1.0 | Apr 2025 | Initial prototype with basic credibility scoring |

syscred-2.2.0.dist-info/RECORD

@@ -0,0 +1,28 @@
+syscred/__init__.py,sha256=lkX2w8c1ArcrgOOWCPVMs99wXPVFZ7BEvqOUeUEokFI,1219
+syscred/api_clients.py,sha256=zNm2Q5IOu8BlKU20mbyC6oCP5d2lJDcKT2mDjyNoO0U,20106
+syscred/backend_app.py,sha256=tWt3m7FqIcq1zwkgRqbAkMB6QWlQkta2Y3v2wB92MqU,12813
+syscred/config.py,sha256=FGR1pnbBD-bEpZZYKhEIYUwZsgMVDJ_Hx6KNMqZ8DpM,8511
+syscred/database.py,sha256=4jRZiiiylRF3FNqvcPKbZo-hZxsFuRIbwBY5WJo_uco,1773
+syscred/debug_factcheck.py,sha256=uskTER3240PZaqZxG_5Sa1LnjMmeQK17gLW7DH372aE,1370
+syscred/debug_graph_json.py,sha256=UVDK7No426Hlmjo924c18o4SQv5mKLXf-jeP1ZBQdEE,1878
+syscred/debug_init.py,sha256=lXZpkz2muqPQTmZD-dTmkSgPloNO0zlqVPPl3eriGHw,995
+syscred/debug_local_server.py,sha256=uuEtawPQJyI7NbBQNGP9k4cABJJA6lBHAB08ygJGmY0,810
+syscred/diagnose_imports.py,sha256=Jmsblj0I9uQqDmrxgP1TvbT6oaOfwAk_HRgnoKwVo6A,853
+syscred/eval_metrics.py,sha256=HTibLJqTBj9O-W2YvtzPui8-IspYXI22ipZBASOJ77s,11248
+syscred/graph_rag.py,sha256=XjfGBLEhNHOZ5-ocKdfJuUBiF1XgFI4-Vnv9nFtJGzY,6127
+syscred/ir_engine.py,sha256=ewggTpvKHJfKdGXFSCkIhJBw_GWZEReE_btVlDiw80E,12310
+syscred/ontology_manager.py,sha256=TjOyWXAWDduIiDF4JYSu1M9eLBKXTDAu007_NSEmc58,20328
+syscred/run_benchmark.py,sha256=NuMt4jx6BPHAg-FN0hv7O8_ClTi7aYEJji2IGSmjTpw,4616
+syscred/seo_analyzer.py,sha256=fkjuC5j4XFLjU5Qbe5VOwE8m5diIMydL618c-KGq_4I,21360
+syscred/setup.py,sha256=QCguZTGs7iLCAYm_QyFJnOMDt8ATnhH-dkYYRBZFQ7Q,1998
+syscred/test_graphrag.py,sha256=6V5__cWvsWHhzA84iOyJBddP4Uiv4-pLSRe04EMDz4U,3211
+syscred/test_phase1.py,sha256=yvF7YJvdhUNRqn33QTmcPG9xYSZWq-jVc9g7DzoKirg,783
+syscred/test_phase2.py,sha256=6up3_5HSMFLx08UzYkTcEQ6fJxMGD2vWeC1E8ecOOJg,2097
+syscred/test_suite.py,sha256=VA3kH7-FV8AeAgo3q9J-Ag4QRqZj9JvbUfdJaI3CJp0,2711
+syscred/verification_system.py,sha256=c9eDgSTuci3z0XMwPtmGqPgXIFvhGlI4KA7eVjv63uQ,30641
+syscred-2.2.0.dist-info/licenses/LICENSE,sha256=UxA2SCp1e_CJspsrL2NhfkCAzQJ7ouc9KtV1VYwk3cM,1080
+syscred-2.2.0.dist-info/METADATA,sha256=4SkAfJUZHKmuO-Hpvk0DJasv3gXmiLG3zW-wI8q40lQ,8769
+syscred-2.2.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+syscred-2.2.0.dist-info/entry_points.txt,sha256=kiFeLZt9Xh-k_WxA1wZ_kqUp9vZzoaJPEkwisoptz0U,104
+syscred-2.2.0.dist-info/top_level.txt,sha256=dv8byzr5GEXZ1l4YwcmMQckbbEXnmTBbaAJiLCMBe0o,8
+syscred-2.2.0.dist-info/RECORD,,

syscred-2.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

syscred-2.2.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+syscred-server = syscred.backend_app:main
+syscred-verify = syscred.cli:verify_command

syscred-2.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Dominique S. Loyer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

syscred-2.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+syscred