Semantic Security Suite 🔮🛡️

A premium, zero-dependency (other than NLTK and NumPy) text processing, semantic transformation, and cryptographic security suite. It includes a complete set of tools for NLP, machine learning, template rendering, and invisible steganography, all integrated into a unified web-based glassmorphism dashboard.

---

🚀 Key Features

• 🔮 Semantic Shifter (semantic_shifter.py): Uses WordNet synsets to perform context-aware synonym, antonym, intensity (intensify/weaken), and conceptual hierarchy shifts on English text.
• ✉️ Steganography Engine (steganography.py): Embeds secret messages inside innocent cover text invisibly by encoding binary bits into zero-width Unicode characters (\u200b, \u200c).
• 🛡️ Advanced Obfuscator (obfuscator.py): Protects text payloads using a Vigenère cipher with a dynamic key derived from text structure, combined with deterministic chaffing (noise word) injection.
• ⛓️ Blockchain Verification Ledger (blockchain.py): A simulation of a decentralized ledger with Proof of Work mining to record and cryptographically verify the integrity of text transformations.
• 🧠 Machine Learning Clustering (ml_encoder.py): Implements K-Means clustering from scratch in pure NumPy. Builds contextual co-occurrence matrices to group semantically similar words.
• 🧠 Neural Network Token Predictor (neural_predictor.py): A custom 2-layer Neural Network Language Model (NNLM) built with NumPy. Learns word-to-word transition probabilities (bigram predictions) using backpropagation and SGD.
• ⚙️ Dynamic Template Engine (template_engine.py): Renders templates with custom pipe filters (e.g., {{ name | title }} or {{ text | antonym }}) dynamically.
• 📡 Real-time Anti-Detection (anti_detector.py): Calculates character-level Shannon Entropy and Lexical Diversity (TTR) of text and applies dynamic evasion tweaks to bypass pattern classifiers.
• 🧬 Genetic Algorithm Optimizer (genetic_optimizer.py): Uses a multi-generational GA (Selection, Crossover, Mutation) to optimize the selection of word synonyms, balancing readability, lexical diversity, and entropy.
• 💻 Web Dashboard (index.html & api_server.py): A modern, dark cyber-tech glassmorphism web control center served from the local Python HTTP server.

---

🛠️ Installation & Setup

1. Clone the Repository:

   git clone https://github.com/allex2021/emantic-Shifter.git
   cd emantic-Shifter

2. Set Up Virtual Environment:

   python3 -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install Dependencies:

   pip install nltk numpy

---

🎮 Running the Tools

1. Launch the Live Web Dashboard

Start the backend API server:

python3 api_server.py 8080

Open your browser and visit: http://localhost:8080/ to access the graphical control suite.

2. Run the Automated Test Suite & Diagnostics

Run unit testing across all components with real-time feedback loops:

python3 test_runner.py

3. Interactive CLI Mode

Run the console text shifting menu:

python3 interactive_shifter.py

4. Batch Process Text Files

Process a whole folder of .txt files:

python3 batch_processor.py --input input_texts/ --output output_texts/ --shift antonym

5. Running Standalone Demonstrations

You can run any engine individually to see its built-in test outputs:

python3 genetic_optimizer.py    # Run Genetic Optimization
python3 quantum_token.py        # Run Quantum-inspired superpositions
python3 ml_encoder.py           # Run K-Means Semantic Clustering
python3 neural_predictor.py     # Train & Run Neural Network Predictor
python3 blockchain.py           # Run Proof-of-Work Block Minter
python3 anti_detector.py        # Run Entropy Anti-Detection check

---

📄 License

This project is open-source and available under the MIT License.