README.md

---
base_model:
- ReadyArt/Serenity-31B
base_model_relation: quantized
tags:
- gemma-4
- roleplay
- conversational
- instruct
- apache-2.0
- nsfw
- adult-content
- unaligned
- mature
- explicit
- erp
license: apache-2.0
---
<style>
.mc-wrap{background:#0d1117;color:#c9d1d9;font-family:'Inter',sans-serif;max-width:920px;margin:0 auto;padding:24px;border-radius:16px;box-sizing:border-box}
.mc-wrap *{box-sizing:border-box}
.mc-wrap h1,.mc-wrap h2,.mc-wrap h3,.mc-wrap h4{color:#e6edf3;border:none}
.mc-wrap p{color:#c9d1d9}
.mc-wrap strong{color:#7ee8d0}
.mc-wrap a{color:#7ee8d0;text-decoration:none}
.mc-wrap ul{list-style:none;padding-left:0;margin:0}
.mc-wrap li{color:#c9d1d9;margin-bottom:8px;padding-left:4px}
.mc-wrap code{background:#161b22;color:#7ee8d0;padding:2px 8px;border-radius:4px;font-family:'JetBrains Mono',monospace;font-size:.88em;border:1px solid rgba(126,232,208,.15)}
.mc-hdr{text-align:center;padding:40px 32px;background:#0d1117;border:1px solid #21262d;border-radius:24px;margin-bottom:20px;position:relative;overflow:hidden}
.mc-hdr::before{content:'';position:absolute;top:0;left:0;right:0;height:3px;background:linear-gradient(135deg,#7ee8d0,#a78bfa,#c4b5fd)}
.mc-name{font-family:'Space Grotesk',sans-serif;font-size:2.8em;font-weight:800;margin:0;letter-spacing:-.02em;background:linear-gradient(135deg,#7ee8d0,#a78bfa,#c4b5fd);-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text;line-height:1.2}
.mc-badge{display:inline-flex;align-items:center;gap:6px;background:rgba(126,232,208,.12);border:1px solid rgba(126,232,208,.3);padding:6px 16px;border-radius:100px;font-family:'JetBrains Mono',monospace;font-size:.85em;font-weight:600;color:#7ee8d0;margin-top:16px}
.mc-sub{color:#8b949e;font-size:1.05em;margin-top:12px;font-weight:400;font-style:italic}
.mc-warn{padding:14px 24px;border-radius:12px;margin:16px 0;font-weight:500;font-size:.88em;line-height:1.6;background:rgba(167,139,250,.08);border:1px solid rgba(167,139,250,.3);color:#d2b4fc;text-align:center}
.mc-sec{margin:16px 0;padding:24px 28px;background:#0d1117;border:1px solid #21262d;border-radius:16px;position:relative;overflow:hidden}
.mc-sec::before{content:'';position:absolute;top:0;left:0;width:4px;height:100%;background:linear-gradient(135deg,#7ee8d0,#a78bfa,#c4b5fd);opacity:.8}
.mc-sec-title{font-family:'Space Grotesk',sans-serif;font-size:1.4em;font-weight:700;margin:0 0 16px 0;color:#e6edf3;display:flex;align-items:center;gap:10px}
.mc-grid{display:grid;grid-template-columns:1fr 1fr;gap:16px;margin-top:16px}
.mc-card{background:#161b22;padding:20px;border-radius:12px;border:1px solid #21262d}
.mc-card h4{margin:0 0 10px 0;color:#7ee8d0;font-family:'Space Grotesk',sans-serif;font-weight:600;font-size:1em}
.mc-card p{color:#c9d1d9;font-size:.88em;margin:0;line-height:1.6}
.mc-val{font-family:'Space Grotesk',sans-serif;font-size:2.8em;font-weight:800;background:linear-gradient(135deg,#7ee8d0,#a78bfa,#c4b5fd);-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text;margin:8px 0;line-height:1}
.mc-lbl{color:#8b949e;font-size:.85em;line-height:1.5;margin:0}
.mc-tbl{width:100%;border-collapse:separate;border-spacing:0;margin-top:16px;font-family:'JetBrains Mono',monospace;border-radius:12px;border:1px solid #21262d;overflow:hidden}
.mc-tbl th{background:rgba(126,232,208,.08);color:#7ee8d0;padding:12px 20px;text-align:left;font-weight:600;font-size:.75em;text-transform:uppercase;letter-spacing:.08em;border-bottom:1px solid #21262d}
.mc-tbl td{padding:12px 20px;border-bottom:1px solid #21262d;color:#c9d1d9;font-size:.88em;background:#161b22}
.mc-tbl tr:last-child td{border-bottom:none}
.mc-tbl td strong{color:#a78bfa}
.mc-qlinks{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:16px;margin:16px 0}
.mc-btn{display:inline-flex;align-items:center;justify-content:center;background:linear-gradient(135deg,#7ee8d0,#a78bfa,#c4b5fd);color:#0d1117;padding:10px 24px;border-radius:8px;text-decoration:none;border:none;margin:12px 0 0 0;font-weight:600;font-size:.85em;letter-spacing:.04em;text-transform:uppercase;font-family:'Inter',sans-serif;box-shadow:0 4px 12px rgba(126,232,208,.25)}
.mc-ava{width:44px;height:44px;border-radius:50%;margin-right:16px;object-fit:cover;border:2px solid #7ee8d0}
.mc-disclaimer{border-left:3px solid #f0883e;padding:14px 20px;background:rgba(240,136,62,.06);border-radius:0 12px 12px 0;color:#f0883e;font-size:.9em;margin:16px 0}
.mc-tag{display:inline-flex;align-items:center;padding:5px 12px;border-radius:100px;font-size:.72em;font-weight:600;letter-spacing:.06em;text-transform:uppercase;font-family:'JetBrains Mono',monospace;margin:4px}
.t1{background:rgba(126,232,208,.12);color:#7ee8d0;border:1px solid rgba(126,232,208,.3)}
.t2{background:rgba(167,139,250,.12);color:#a78bfa;border:1px solid rgba(167,139,250,.3)}
.t3{background:rgba(196,181,253,.12);color:#c4b5fd;border:1px solid rgba(196,181,253,.3)}
.t4{background:rgba(240,136,62,.12);color:#f0883e;border:1px solid rgba(240,136,62,.3)}
details summary{cursor:pointer;font-family:'Space Grotesk',sans-serif;font-size:1.4em;font-weight:700;color:#e6edf3;padding:24px 28px;background:#161b22;border:1px solid #21262d;border-radius:16px;position:relative;list-style:none;display:flex;align-items:center;gap:10px}
details summary::-webkit-details-marker{display:none}
details summary::before{content:'▶';font-size:.7em;transition:transform .2s}
details[open] summary::before{transform:rotate(90deg)}
details summary::after{content:'';position:absolute;top:0;left:0;width:4px;height:100%;background:linear-gradient(135deg,#7ee8d0,#a78bfa,#c4b5fd);opacity:.8;border-radius:16px 0 0 16px}
details .mc-sec{margin-top:0;border-top-left-radius:0;border-top-right-radius:0;border-top:none}
.mc-video-wrap{position:relative;margin:16px 0;border-radius:16px;overflow:hidden;border:2px solid #7ee8d0}
.mc-video-badge{position:absolute;top:10px;right:10px;background:#7ee8d0;color:#0d1117;font-family:'Inter',sans-serif;font-weight:600;padding:5px 10px;font-size:.8em;border-radius:4px;z-index:2;border:1px solid #161b22}

/* New Fancy Styles */
.sampler-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; margin-top: 15px; }
.param-box { background: rgba(126, 232, 208, 0.05); border: 1px solid rgba(126, 232, 208, 0.2); padding: 12px; border-radius: 8px; text-align: center; transition: all 0.2s ease; }
.param-box:hover { background: rgba(126, 232, 208, 0.1); border-color: rgba(126, 232, 208, 0.4); }
.param-val { font-family: 'JetBrains Mono', monospace; font-size: 1.5em; font-weight: 700; color: #7ee8d0; display: block; margin-bottom: 4px; }
.param-label { font-size: 0.7em; color: #8b949e; text-transform: uppercase; letter-spacing: 0.05em; }
.quant-list { list-style: none; padding: 0; margin: 15px 0; }
.quant-item { display: flex; justify-content: space-between; padding: 8px 0; border-bottom: 1px solid #21262d; font-size: 0.85em; color: #c9d1d9; }
.quant-item:last-child { border-bottom: none; }
.quant-item span:first-child { font-family: 'JetBrains Mono', monospace; color: #a78bfa; }
.mc-btn-glow { box-shadow: 0 0 15px rgba(126, 232, 208, 0.4); transition: all 0.3s ease; width: 100%; }
.mc-btn-glow:hover { box-shadow: 0 0 25px rgba(126, 232, 208, 0.6); transform: translateY(-2px); }
.download-icon { margin-right: 8px; }

@media(max-width:640px){.mc-wrap{padding:12px}.mc-name{font-size:2em}.mc-grid{grid-template-columns:1fr}.mc-qlinks{grid-template-columns:1fr}}
</style>

<div class="mc-wrap">

<div class="mc-hdr">
    <h1 class="mc-name">Serenity-31B</h1>
    <div class="mc-badge">⚡ v1.0</div>
    <p class="mc-sub">Balance achieved. Control surrendered.
    <br>
     <p>Note for thinking to work, you must use "chat_template_kwargs": {"enable_thinking": true, "reasoning_effort": "medium"} in SillyTavern's Chat Completion / Additional Parameters.
      <br>IQ4_XS has broken thinking. Q4_K_M seems to work with the above settings.
     </p>
</div>

<div class="mc-warn">
    Content Advisory: Mature Themes / Adult Interactions — Intended for mature audiences only.
</div>

<div class="mc-video-wrap">
    <span class="mc-video-badge">GEMMA-4 BASED</span>
    <video autoplay loop muted playsinline controls style="width:100%;display:block;border-radius:14px">
        <source src="https://huggingface.co/spaces/ReadyArt/README/resolve/main/Serenity.mp4" type="video/mp4">
    </video>
</div>

<details>
<summary>🌊 What Is Serenity?</summary>
<div class="mc-sec">
    <p>Born from the convergence of two lineages, <strong>Serenity-31B</strong> harmonizes the best of both worlds — the expressive depth of Melody and the immersive presence of Darkside — into a single, balanced model.</p>
    <div style="display:flex;align-items:center;justify-content:center;gap:20px;margin:20px 0;flex-wrap:wrap">
        <div style="text-align:center;padding:20px 32px;background:#161b22;border-radius:12px;border:1px solid #21262d;min-width:140px">
            <div style="font-family:'JetBrains Mono',monospace;font-size:.7em;text-transform:uppercase;letter-spacing:.12em;color:#8b949e;margin-bottom:8px">Lineage A</div>
            <div style="font-family:'Space Grotesk',sans-serif;font-size:1.2em;font-weight:700;color:#7ee8d0">Melody1437</div>
            <div style="font-family:'JetBrains Mono',monospace;font-size:.65em;color:#c4b5fd;margin-top:4px">Male → Female Perspective</div>
        </div>
        <div style="font-size:1.5em;color:#a78bfa">✦</div>
        <div style="text-align:center;padding:20px 32px;background:#161b22;border-radius:12px;border:1px solid #21262d;min-width:140px">
            <div style="font-family:'JetBrains Mono',monospace;font-size:.7em;text-transform:uppercase;letter-spacing:.12em;color:#8b949e;margin-bottom:8px">Lineage B</div>
            <div style="font-family:'Space Grotesk',sans-serif;font-size:1.2em;font-weight:700;color:#c4b5fd">Darkside</div>
            <div style="font-family:'JetBrains Mono',monospace;font-size:.65em;color:#7ee8d0;margin-top:4px">Female → Male Perspective</div>
        </div>
        <div style="font-size:1.5em;color:#a78bfa">→</div>
        <div style="text-align:center;padding:20px 32px;background:rgba(126,232,208,.08);border-radius:12px;border:1px solid #7ee8d0;min-width:140px;box-shadow:0 0 20px rgba(126,232,208,.1)">
            <div style="font-family:'JetBrains Mono',monospace;font-size:.7em;text-transform:uppercase;letter-spacing:.12em;color:#7ee8d0;margin-bottom:8px">Hybrid</div>
            <div style="font-family:'Space Grotesk',sans-serif;font-size:1.4em;font-weight:700;background:linear-gradient(135deg,#7ee8d0,#a78bfa,#c4b5fd);-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text">Serenity</div>
        </div>
    </div>
    <div class="mc-warn" style="background:rgba(240,136,62,.08);border-color:rgba(240,136,62,.3);color:#f0883e">
        ⚠️ <strong>Perspective Note:</strong> Due to the merger of opposing perspective lineages, this tune may occasionally exhibit perspective confusion.
    </div>
    <ul>
        <li>🧠 <strong>Dual Heritage:</strong> Combines Melody's male → female perspective with Darkside's female → male perspective</li>
        <li>⚖️ <strong>Balanced Tone:</strong> Refined personality that flows naturally without overwhelming the narrative</li>
        <li>🎭 <strong>Enhanced Depth:</strong> LoRA 80 captures nuanced behavioral patterns from both parent approaches</li>
    </ul>
</div>
</details>

<details>
<summary>🧬 Synthetic Life Engine</summary>
<div class="mc-sec">
    <p>Dataset generated using our advanced <strong>Character Engine</strong> and <strong>Emotional Engine</strong>, creating genuine life and emotional resonance in every interaction.</p>
    <div class="mc-grid">
        <div class="mc-card">
            <h4>🎭 Character Engine</h4>
            <p>Ensures consistent personality traits, speech patterns, and behavioral logic across all contexts. Characters remain true to themselves throughout.</p>
        </div>
        <div class="mc-card">
            <h4>💓 Emotional Engine</h4>
            <p>Injects dynamic emotional states into responses, creating depth and realistic reactions that breathe life into every exchange.</p>
        </div>
        <div class="mc-card">
            <h4>✨ Quality Refinement</h4>
            <p>Automated detection and rewriting of repetitive phrases ensures fresh, high-quality dialogue in every turn.</p>
        </div>
        <div class="mc-card">
            <h4>💬 Dialogue Integrity</h4>
            <p>Advanced quote normalization ensures balanced dialogue markers, preventing formatting errors and maintaining immersion.</p>
        </div>
    </div>
</div>
</details>

<details>
<summary>🧠 Training Details & Parameters</summary>
<div class="mc-sec">
    <p>Fine-tuned using <strong>LoRA (Low-Rank Adaptation)</strong> for efficient and targeted weight adjustment, preserving the base model's capabilities while imprinting new behavioral patterns.</p>
    <div class="mc-grid">
        <div class="mc-card" style="text-align:center">
            <h4>🔢 Epochs</h4>
            <div class="mc-val">2</div>
            <p class="mc-lbl">Full passes through the training dataset for thorough learning</p>
        </div>
        <div class="mc-card" style="text-align:center">
            <h4>📐 LoRA Rank</h4>
            <div class="mc-val">80</div>
            <p class="mc-lbl">Higher rank for richer adaptation and nuanced expression</p>
        </div>
    </div>
    <table class="mc-tbl">
        <thead><tr><th>Parameter</th><th>Value</th></tr></thead>
        <tbody>
            <tr><td>Training Method</td><td><strong>LoRA (Low-Rank Adaptation)</strong></td></tr>
            <tr><td>LoRA Rank (r)</td><td><strong>80</strong></td></tr>
            <tr><td>Epochs</td><td><strong>2</strong></td></tr>
            <tr><td>Trained Layers</td><td><strong>Text layers only</strong></td></tr>
        </tbody>
    </table>
    <ul style="margin-top:16px">
        <li>🎯 <strong>Method:</strong> LoRA fine-tuning for parameter-efficient adaptation, preserving base knowledge while imprinting new behaviors</li>
        <li>⚡ <strong>Efficiency:</strong> Only a fraction of parameters updated, keeping the model lean and responsive</li>
        <li>🎭 <strong>Result:</strong> Maintains coherence while exhibiting the desired personality traits and interaction style</li>
    </ul>
</div>
</details>

<details>
<summary>🔮 Training Process</summary>
<div class="mc-sec">
    <p>Model weights subjected to <strong>iterative refinement</strong> during data creation. Each conversation underwent multiple checks for stability and alignment.</p>
    <ul>
        <li>🔄 <strong>Multi-Turn Generation:</strong> Conversations built turn-by-turn for natural context flow</li>
        <li>🛡️ <strong>Refusal Filtering:</strong> Automated systems detected and removed unwanted refusals</li>
        <li>🧹 <strong>Slop Cleaning:</strong> Undesirable phrases identified and rewritten by dedicated assistant models</li>
    </ul>
</div>
</details>

<details>
<summary>📚 Dataset Overview</summary>
<div class="mc-sec">
    <p>Model trained on a <strong>specialized adult-oriented roleplay dataset</strong> with diverse scenarios and emotional contexts, drawing from the strengths of both parent lineages.</p>
    <ul>
        <li>🔞 <strong>Content Rating:</strong> Strictly 18+ (Adults Only)</li>
        <li>🎭 <strong>Focus:</strong> Mature themes, immersive roleplay, uncensored dialogue</li>
    </ul>
</div>
</details>

<details>
<summary>📜 Version Notes</summary>
<div class="mc-sec">
    <ul>
        <li>⚠️ <strong>Content Warning:</strong> This model can generate mature content. Use responsibly.</li>
        <li>🧹 <strong>Clean Output:</strong> Reasoning tags and excessive markdown stripped for cleaner roleplay</li>
        <li>🔀 <strong>Hybrid Lineage:</strong> Combines the male → female perspective of Melody1437 with the female → male perspective of Darkside into a unified, balanced model</li>
    </ul>
</div>
</details>

<details>
<summary>⚙️ Configuration</summary>
<div class="mc-sec">
    <div class="mc-qlinks">
        <!-- Sampler Settings Box -->
        <div class="mc-card">
            <h4>🎛️ Sampler Settings</h4>
            <p style="margin-bottom:10px;font-size:0.8em;color:#8b949e">Recommended parameters for optimal output</p>
            <div class="sampler-grid">
                <div class="param-box">
                    <span class="param-val">0.92</span>
                    <span class="param-label">Top-P</span>
                </div>
                <div class="param-box">
                    <span class="param-val">1.0</span>
                    <span class="param-label">Temperature</span>
                </div>
                <div class="param-box">
                    <span class="param-val">0</span>
                    <span class="param-label">Freq Pen</span>
                </div>
                <div class="param-box">
                    <span class="param-val">0</span>
                    <span class="param-label">Presence Pen</span>
                </div>
            </div>
        </div>
        <!-- GGUF Download Box -->
        <div class="mc-card">
            <h4>📦 GGUF Quantizations</h4>
            <p style="font-size:0.8em;color:#8b949e">Available formats for local inference</p>
            <ul class="quant-list">
                <li class="quant-item"><span>Q4_K_M</span><span>Decent Quality</span></li>
                <li class="quant-item"><span>Q5_K_M</span><span>Recommended</span></li>
                <li class="quant-item"><span>Q6_K</span><span>High Quality</span></li>
                <li class="quant-item"><span>Q8_0</span><span>Near Lossless</span></li>
            </ul>
            <a href="https://huggingface.co/ReadyArt/Serenity-31B-GGUF" class="mc-btn mc-btn-glow">
                <span class="download-icon">⬇</span> View Repository
            </a>
        </div>
    </div>
</div>
</details>

<details>
<summary>💖 Credits</summary>
<div class="mc-sec">
    <ul>
        <li style="display:flex;align-items:center;margin-bottom:12px;padding:16px 20px;background:#161b22;border:1px solid #21262d;border-radius:12px">
            <img src="https://cdn-avatars.huggingface.co/v1/production/uploads/673fa5ccbf2e9c35b2ec841a/rPHaMrqyYTfSJ89NN8KgY.jpeg" alt="Darkhn" class="mc-ava">
            <span><strong>Darkhn</strong> — Fixing Thinking</span>
        </li>
        <li style="display:flex;align-items:center;margin-bottom:12px;padding:16px 20px;background:#161b22;border:1px solid #21262d;border-radius:12px">
            <img src="https://huggingface.co/avatars/55f24699e05af4295a9d16ddecd81f8a.svg" alt="GECFDO" class="mc-ava">
            <span><strong>GECFDO</strong> — Data Generation & iMatrix Quants</span>
        </li>
        <li style="display:flex;align-items:center;margin-bottom:12px;padding:16px 20px;background:#161b22;border:1px solid #21262d;border-radius:12px">
            <img src="https://huggingface.co/avatars/75a3eb8d24efb96b7b7e69340845028f.svg" alt="Sleep Deprived" class="mc-ava">
            <span><strong>Sleep Deprived</strong> — Dataset Generator</span>
        </li>
        <li style="display:flex;align-items:center;margin-bottom:12px;padding:16px 20px;background:#161b22;border:1px solid #21262d;border-radius:12px">
            <img src="https://cdn-avatars.huggingface.co/v1/production/uploads/6759e155bc947d6070775cb9/FW3jKJ-t8iH9MPGeWzyX5.png" alt="FrenzyBiscuit" class="mc-ava">
            <span><strong>FrenzyBiscuit</strong> — Fine-Tuning & Dataset Creation</span>
        </li>
    </ul>
</div>
</details>

<div class="mc-sec">
    <h2 class="mc-sec-title">🔖 License & Usage</h2>
    <div class="mc-disclaimer">
        <strong>⚠️ Usage Agreement:</strong> By using this model, you accept all terms and conditions.
    </div>
    <ul>
        <li>📜 Built upon the <strong>Apache 2.0</strong> license</li>
        <li>🛡️ You accept <strong>full responsibility</strong> for all outputs generated</li>
        <li>🔞 You confirm you are at least <strong>18 years old</strong></li>
        <li>🌍 Creators bear <strong>no responsibility</strong> for how the model is used</li>
        <li>🏡 For <strong>personal use only</strong> (non-profit/non-commercial) to the extent legally allowed</li>
    </ul>
    <div style="margin-top:16px">
        <span class="mc-tag t1">Apache 2.0</span>
        <span class="mc-tag t2">Personal Use</span>
        <span class="mc-tag t3">18+ Content</span>
        <span class="mc-tag t4">NSFW</span>
    </div>
</div>

</div>