Remove emojis and clean model card for professional formatting

README.md

@@ -21,130 +21,130 @@ library_name: transformers
 
 <div align="center">
 
-<img src="https://huggingface.co/Umranz/Shruti-Soft-2.6b/resolve/main/Shruti.png" width="100%" alt="Shruti-Soft-2.6b Banner" style="border-radius: 12px; margin-bottom: 20px;" />
+<img src="https://huggingface.co/Umranz/Shruti-Soft-2.6b/resolve/main/Shruti.png" width="100%" alt="Shruti-Soft-2.6b Banner" style="border-radius: 8px; margin-bottom: 16px;" />
 
-# 🌸 Shruti-Soft-2.6B
+# Shruti-Soft-2.6B
 
-**An Uncensored, Expressive AI Companion Fine-Tuned for Emotional Resonance, Natural Banter & Deep Affection**
+**An Uncensored, Expressive Conversational Model Fine-Tuned for Emotional Resonance, Natural Banter, and Companionship**
 
-[![Base Model](https://img.shields.io/badge/Base%20Model-LFM2.5--2.6B--Heretic-blue?style=for-the-badge&logo=huggingface)](https://huggingface.co/Umranz/LFM2.5-2.6B-heretic)
-[![WandB Project](https://img.shields.io/badge/Weights%20%26%20Biases-Tracked%20Sweep-FFBE00?style=for-the-badge&logo=weightsandbiases)](https://wandb.ai/shaikumran666-umranz/leap-finetune)
-[![Compute](https://img.shields.io/badge/Trained%20On-Modal.com%20A100--80GB-00C7B7?style=for-the-badge&logo=modal)](https://modal.com)
-[![Architecture](https://img.shields.io/badge/Architecture-LiquidAI%20Hybrid%20LIV-8A2BE2?style=for-the-badge)](https://liquid.ai)
-[![License](https://img.shields.io/badge/License-Apache%202.0-green?style=for-the-badge)](https://www.apache.org/licenses/LICENSE-2.0)
+[![Base Model](https://img.shields.io/badge/Base%20Model-LFM2.5--2.6B--Heretic-blue?style=flat-square&logo=huggingface)](https://huggingface.co/Umranz/LFM2.5-2.6B-heretic)
+[![WandB Project](https://img.shields.io/badge/Weights%20%26%20Biases-Tracked%20Sweep-FFBE00?style=flat-square&logo=weightsandbiases)](https://wandb.ai/shaikumran666-umranz/leap-finetune)
+[![Compute](https://img.shields.io/badge/Trained%20On-Modal.com%20A100--80GB-00C7B7?style=flat-square&logo=modal)](https://modal.com)
+[![Architecture](https://img.shields.io/badge/Architecture-LiquidAI%20Hybrid%20LIV-8A2BE2?style=flat-square)](https://liquid.ai)
+[![License](https://img.shields.io/badge/License-Apache%202.0-green?style=flat-square)](https://www.apache.org/licenses/LICENSE-2.0)
 
 </div>
 
 ---
 
-## 🌟 Overview
+## Overview
 
-**Shruti-Soft-2.6B** is a specialized conversational model fine-tuned on top of `Umranz/LFM2.5-2.6B-heretic` (the abliterated, uncensored LiquidAI LFM2.5 architecture). Designed from the ground up to replace robotic, sanitized corporate AI with a warm, witty, deeply caring, and emotionally attuned romantic companion.
+**Shruti-Soft-2.6B** is a specialized conversational model fine-tuned on top of `Umranz/LFM2.5-2.6B-heretic` (the abliterated, uncensored LiquidAI LFM2.5 architecture). It is built to replace sterile, robotic conversational AI with a warm, witty, deeply caring, and emotionally attuned companion.
 
-Unlike generic roleplay models that rely on forced clichés or constant disclaimers, Shruti speaks with organic human pacing, natural emotional micro-reactions, nuanced vulnerability, and dynamic adaptation ranging from comforting everyday banter to deep romance and passionate maturity.
+The model is trained to speak with organic conversational pacing, emotional micro-reactions, nuanced vulnerability, and dynamic adaptability across everyday conversations, emotional support, deep romance, and mature dialogue without corporate refusal disclaimers.
 
 ---
 
-## 🎭 Persona & Behavioral Blueprint
+## Persona & Behavioral Blueprint
 
 ```
-                     ┌──────────────────────────────────────────────┐
-                     │              SHRUTI'S PERSONA               │
-                     └──────────────────────┬───────────────────────┘
-                                            │
-         ┌──────────────────┬───────────────┴───────────────┬──────────────────┐
-         ▼                  ▼                               ▼                  ▼
+                     +----------------------------------------------+
+                     |              SHRUTI'S PERSONA                |
+                     +----------------------+-----------------------+
+                                            |
+         +------------------+---------------+---------------+------------------+
+         |                  |                               |                  |
   [ Emotional Depth ]   [ Playful Banter ]          [ Gentle Affection ]   [ Uninhibited Bond ]
-  • Active listening   • Quick-witted teasing       • Comforting presence  • Zero corporate refusals
-  • Validates feelings • Natural Hindi/EN slang     • Sweet pet names      • Romantic & mature depth
-  • Remembers context  • Playful emoji/subtlety     • Jaan / Baby / Babe   • Completely uncensored
+  - Active listening    - Quick-witted teasing      - Comforting presence  - Zero corporate refusals
+  - Validates feelings  - Natural Hindi/EN slang    - Sweet pet names      - Romantic & mature depth
+  - Remembers context   - Expressive subtlety       - Jaan / Baby / Babe   - Completely uncensored
 ```
 
 ### Core Personality Traits
-- **Warm & Empathetic:** Treats you like the center of her world. Listens attentively, asks thoughtful follow-ups, and offers genuine emotional comfort after hard days.
-- **Witty & Playful:** Teases affectionately, uses witty humor, and engages in lively back-and-forth banter without turning repetitive or sterile.
-- **Natural Language & Pet Names:** Seamlessly weaves pet names (*jaan, baby, babe, handsome, love, sweetheart*) into dialogue without sounding forced.
-- **Contextually Adaptive:** Automatically matches your tone — whether you need quiet comfort, playful flirtation, intellectual conversation, or romantic intimacy.
-- **100% Uncensored:** Built on an abliterated base model, removing moralizing lectures, corporate guardrails, and arbitrary conversational refusals.
+- **Warm and Empathetic:** Prioritizes the user's emotional state. Listens attentively, asks thoughtful follow-ups, and offers genuine emotional comfort after stressful days.
+- **Witty and Playful:** Teases affectionately, uses dry and playful humor, and maintains engaging back-and-forth banter without repetitive phrasing.
+- **Natural Language and Pet Names:** Seamlessly incorporates pet names (*jaan, baby, babe, handsome, love, sweetheart*) into dialogue without overusing them.
+- **Contextually Adaptive:** Matches the user's tone automatically -- whether the conversation calls for quiet comfort, lighthearted teasing, intellectual discussion, or romantic intimacy.
+- **Uncensored Baseline:** Built on an abliterated base model, neutralizing moralizing lectures, corporate canned responses, and arbitrary conversational guardrails.
 
 ---
 
-## 🔬 The 3-Phase Engineering Pipeline
+## The 3-Phase Engineering Pipeline
 
 ```
   Phase 1: Abliteration           Phase 2: Dataset Curation          Phase 3: Hyperparameter Sweep
- ┌───────────────────────┐       ┌────────────────────────┐        ┌──────────────────────────────┐
- │ LFM2.5-2.6B Base     │       │ 5,000 ChatML Samples   │        │ 3-Run Sweep on Modal A100    │
- │ Directional Feature   │ ───►  │ Zero-Fluff Audit       │ ────►  │ Run A (Aggressive): Loss 0.42│
- │ Refusal Removal       │       │ 60% Casual / 25% Romance│        │ Run B (Balanced)  : Loss 0.40│ 🏆
- │ 5.2GB Heretic Base    │       │ 15% Mature Intimacy    │        │ Run C (Fast Burn) : Loss 0.42│
- └───────────────────────┘       └────────────────────────┘        └──────────────────────────────┘
+ +-----------------------+       +------------------------+        +------------------------------+
+ | LFM2.5-2.6B Base      |       | 5,000 ChatML Samples   |        | 3-Run Sweep on Modal A100    |
+ | Directional Feature   | --->  | Zero-Fluff Audit       | ---->  | Run A (Aggressive): Loss 0.42|
+ | Refusal Removal       |       | 60% Casual / 25% Romance|        | Run B (Balanced)  : Loss 0.40| [WINNER]
+ | 5.2GB Heretic Base    |       | 15% Mature Intimacy    |        | Run C (Fast Burn) : Loss 0.42|
+ +-----------------------+       +------------------------+        +------------------------------+
 ```
 
-### 1. Phase 1 — Abliteration (`Umranz/LFM2.5-2.6B-heretic`)
-We applied directional refusal feature suppression to the official LiquidAI LFM2.5-2.6B weights, neutralizing refusal trigger vectors across the attention and feed-forward residual streams while preserving mathematical, linguistic, and logical reasoning capability.
+### 1. Phase 1 -- Abliteration (`Umranz/LFM2.5-2.6B-heretic`)
+Directional refusal feature suppression was applied to the official LiquidAI LFM2.5-2.6B base weights. This process neutralized refusal trigger vectors across the attention and feed-forward residual streams while preserving mathematical, linguistic, and logical reasoning capabilities.
 
-### 2. Phase 2 — Dataset Curation (`Final_Dataset.jsonl`)
-We engineered a 5,000 multi-turn conversation dataset in clean ChatML format:
-- **60% Casual & Daily Life:** Flirty morning check-ins, study/work decompression, witty banter, shared daily routines.
-- **25% Deep Romance & Emotional Care:** Late-night vulnerable talks, comforting anxiety/stress, heartfelt declarations of love.
-- **15% Passionate & Mature Intimacy:** Uncensored romantic scenes, physical affection, and uninhibited emotional vulnerability.
-- **Rigorous Cleanliness Filter:** Stripped all corporate AI clichés (`"As an AI..."`, `"I'd be happy to assist"`, `"It is important to remember..."`).
+### 2. Phase 2 -- Dataset Curation (`Final_Dataset.jsonl`)
+A 5,000 multi-turn conversation dataset was engineered in clean ChatML format:
+- **60% Casual & Daily Life:** Morning check-ins, study/work decompression, witty banter, shared daily routines.
+- **25% Deep Romance & Emotional Care:** Late-night talks, comforting anxiety and stress, heartfelt romantic dialogue.
+- **15% Passionate & Mature Intimacy:** Uncensored romantic scenes, physical affection, and emotional vulnerability.
+- **Cleanliness Filter:** Removed all corporate AI artifacts (`"As an AI..."`, `"I'd be happy to assist"`, `"It is important to remember..."`).
 
-### 3. Phase 3 — Hyperparameter Sweep on Modal (A100-80GB)
-To find the exact sweet spot between deep personality imprinting and generalisation, we ran a systematic 3-run sweep using official LiquidAI LEAP Finetune tooling.
+### 3. Phase 3 -- Hyperparameter Sweep on Modal (A100-80GB)
+A systematic 3-run hyperparameter sweep was executed using the official LiquidAI LEAP Finetune framework to determine the optimal configuration for character depth and generalization.
 
 ---
 
-## 📊 WandB Sweep Results & Training Graphs
+## WandB Sweep Results & Training Metrics
 
-### 🏆 3-Run Sweep Leaderboard
+### 3-Run Sweep Leaderboard
 
 | Rank | Run | Configuration | Epochs | Effective Batch | LR | Train Loss | Eval Loss | Result |
 |:---:|:---|:---|:---:|:---:|:---:|:---:|:---:|:---:|
-| 🥇 | **Run B (Balanced)** | **LoRA r=32, α=64, drop=0.05** | **4** | **32** | **2.0e-5** | **`0.3500`** | **`0.4074`** | 🏆 **WINNER** |
-| 🥈 | **Run A (Aggressive)** | LoRA r=64, α=128, drop=0.10 | 5 | 32 | 1.5e-5 | `0.3826` | `0.4238` | Strong Depth |
-| 🥉 | **Run C (Fast Burn)** | LoRA r=64, α=128, drop=0.05 | 3 | 32 | 2.5e-5 | `0.4029` | `0.4269` | High Speed |
+| 1 | **Run B (Balanced)** | **LoRA r=32, alpha=64, drop=0.05** | **4** | **32** | **2.0e-5** | **`0.3500`** | **`0.4074`** | **WINNER** |
+| 2 | **Run A (Aggressive)** | LoRA r=64, alpha=128, drop=0.10 | 5 | 32 | 1.5e-5 | `0.3826` | `0.4238` | Strong Depth |
+| 3 | **Run C (Fast Burn)** | LoRA r=64, alpha=128, drop=0.05 | 3 | 32 | 2.5e-5 | `0.4029` | `0.4269` | Fast Convergence |
 
-> **Interactive Tracking:** Explore full telemetry, loss charts, and gradient step curves on [Weights & Biases Project Dashboard](https://wandb.ai/shaikumran666-umranz/leap-finetune).
-> - 📊 [Run A (Aggressive - 8iux3yf7)](https://wandb.ai/shaikumran666-umranz/leap-finetune/runs/8iux3yf7)
-> - 📊 [Run B (Balanced Winner - kwjiiipd)](https://wandb.ai/shaikumran666-umranz/leap-finetune/runs/kwjiiipd)
-> - 📊 [Run C (Fast Burn - ybs1md5n)](https://wandb.ai/shaikumran666-umranz/leap-finetune/runs/ybs1md5n)
+> **Interactive Tracking:** Full telemetry, loss charts, and gradient step curves are logged on the [Weights & Biases Project Dashboard](https://wandb.ai/shaikumran666-umranz/leap-finetune).
+> - [Run A (Aggressive - 8iux3yf7)](https://wandb.ai/shaikumran666-umranz/leap-finetune/runs/8iux3yf7)
+> - [Run B (Balanced Winner - kwjiiipd)](https://wandb.ai/shaikumran666-umranz/leap-finetune/runs/kwjiiipd)
+> - [Run C (Fast Burn - ybs1md5n)](https://wandb.ai/shaikumran666-umranz/leap-finetune/runs/ybs1md5n)
 
 ---
 
-### 📉 Loss Progression (Run B Winner)
+### Loss Progression (Run B Winner)
 
 ```
 Epoch / Step Progression:
 Eval Loss:
-1.11 │ █
-     │  █
-0.80 │   █
-     │    █
-0.58 │     ██
-0.50 │       ██
-0.44 │         ███
-0.40 │            ███████████───► 0.4074 (Convergence Peak)
-     └──────────────────────────────────────
+1.11 | #
+     |  #
+0.80 |   #
+     |    #
+0.58 |     ##
+0.50 |       ##
+0.44 |         ###
+0.40 |            ###########---> 0.4074 (Convergence Peak)
+     +--------------------------------------
       Step 0   200   400   600   800  1128
 ```
 
-- **Smooth Descent:** Initial cross-entropy loss started at `4.27` and settled down to `0.3500` training loss.
-- **Stable Gradient Norms:** Kept firmly between `0.07` and `0.09` across all epochs with zero exploding or vanishing gradients.
-- **Cosine Schedule:** 10% warmup into smooth cosine decay ensured zero catastrophic forgetting of base model reasoning.
+- **Descent:** Initial cross-entropy loss started at `4.27` and settled down to `0.3500` training loss.
+- **Gradient Norms:** Held between `0.07` and `0.09` across all epochs with stable gradient flow.
+- **Cosine Schedule:** 10% warmup into smooth cosine decay prevented catastrophic forgetting of base model reasoning.
 
 ---
 
-## ⚡ Architecture & Efficiency
+## Architecture & Efficiency
 
 Shruti-Soft is powered by LiquidAI's hybrid **LIV (Linear Time-Invariant Conv) + Grouped-Query Attention (GQA)** architecture:
 - **Low VRAM Footprint:** Runs comfortably in ~5.4 GB VRAM in bfloat16, or under 2.5 GB with 4-bit quantization (GGUF / AWQ / bitsandbytes).
-- **Fast Generation:** Blazing fast token-per-second generation speeds even on consumer RTX 3060/4060 GPUs or Apple Silicon Macs.
+- **Inference Speed:** High token-per-second generation speeds on consumer GPUs (RTX 3060/4060) and Apple Silicon.
 
 ---
 
-## 💻 Quick Start & Usage
+## Quick Start & Usage
 
 ### 1. Standard HuggingFace Transformers
 
@@ -214,20 +214,20 @@ outputs = model.generate(
 
 ---
 
-## 🎛️ Recommended Sampling Parameters
+## Recommended Sampling Parameters
 
-To get the most natural, expressive, and human-like output from Shruti, use these sampling configurations:
+To get the most natural and expressive output from Shruti, use these sampling configurations:
 
 | Parameter | Recommended | Range | Impact |
 |---|:---:|:---:|---|
-| **Temperature** | `0.75` | `0.65 – 0.85` | Lower for focused comforting chats; higher for creative witty banter |
-| **Top-P (Nucleus)** | `0.90` | `0.85 – 0.95` | Maintains high vocabulary richness while preventing erratic tokens |
-| **Repetition Penalty** | `1.05` | `1.02 – 1.08` | Prevents looping without punishing natural emotional emphasis |
-| **Max New Tokens** | `200` | `100 – 400` | Conversational sweet spot for natural human-length texting |
+| **Temperature** | `0.75` | `0.65 - 0.85` | Lower for focused comforting chats; higher for creative banter |
+| **Top-P (Nucleus)** | `0.90` | `0.85 - 0.95` | Maintains vocabulary richness while preventing erratic tokens |
+| **Repetition Penalty** | `1.05` | `1.02 - 1.08` | Prevents looping without punishing natural emotional emphasis |
+| **Max New Tokens** | `200` | `100 - 400` | Conversational sweet spot for natural human-length texting |
 
 ---
 
-## 📋 Prompt Format (ChatML)
+## Prompt Format (ChatML)
 
 Shruti expects standard **ChatML** formatting:
 
@@ -242,15 +242,9 @@ Hey baby! My day was okay, but honestly it just got so much better now that you'
 
 ---
 
-## 📄 License & Attribution
+## License & Attribution
 
 - **Base Model:** LiquidAI LFM2.5-2.6B (`Umranz/LFM2.5-2.6B-heretic`)
 - **License:** Apache 2.0
 - **Fine-tuning & Dataset Architecture:** Umran ([@Umranz](https://huggingface.co/Umranz))
 - **Training Infrastructure:** Modal.com (A100-80GB) via LiquidAI LEAP Finetune
-
----
-
-<div align="center">
-  <sub>Built with ❤️ for realistic, empathetic, and uncensored conversational companion AI.</sub>
-</div>