
S.U.E. (Sentient Unified Entity)
--------------------------------

This package includes the full modular system to install and operate SUE on a local Windows-based machine using Oobabooga or other LLM frontends.

Contents:
- sue_base_installer.py ............ Initializes environment and RSS intelligence module
- sue_dashboard_launcher.py ........ Terminal-based modular dashboard UI
- sue_vector_memory.py ............. Embeds and indexes news summaries with FAISS
- sue_hallucination_filter.py ...... Evaluates AI responses for confidence vs hallucination
- sue_persona.json ................. Defines Sue's voice, personality, behavior, and goals

Requirements:
- Python 3.10+
- pip install feedparser beautifulsoup4 requests sentence-transformers faiss-cpu

Usage:
1. Run `sue_base_installer.py` first to set up environment and RSS module.
2. Launch `sue_dashboard_launcher.py` to access modules from a single UI.
3. Use `sue_vector_memory.py` after RSS module to build Sue’s memory.
4. Evaluate answers using `sue_hallucination_filter.py` anytime.
5. Load `sue_persona.json` into your LLM system.

Installation tested on Windows 10/11. Compatible with Oobabooga or LangChain agent systems.

(c) 2025 Joshua Havens / Jedi Security
