---
license: mit
license_link: https://github.com/SentiVerse-AI/SoulX/blob/main/LICENSE
language:
- en
pipeline_tag: text-generation
tags:
- gaming
- npc-dialogue
- character-generation
- interactive-storytelling
- bittensor
library_name: transformers
---

# SoulX: Instruction-Tuned LLM for Interactive Game Characters

`SoulX` is a **role-conditioned, memory-aware language model** built to generate vivid, in-character NPC dialogues. It is the flagship model of **SoulX (Subnet 115)**, the premier protocol for forging sentient **Digital Souls**, built upon our foundational **AIX (Artificial Intelligence Exchange) platform**.

---

## 🌟 Core Capabilities

*   **Contextual NPC Dialogue Generation**
    Given a scene setup, player intent, and character profile, the model generates emotionally consistent, personality-driven interactions.
*   **Memory & Role Conditioning**
    Remembers previous dialogue turns and maintains narrative context across multiple exchanges.
*   **Style-Flexible Outputs**
    Mimics genre-specific tone — fantasy, cyberpunk, JRPG, post-apocalyptic, and more.
*   **Cooperative Narrative Progression**
    NPCs not only respond — they guide the player naturally toward objectives or story arcs.
*   **Validator-Driven Fine-Tuning Loop**
    Designed to integrate into the Bittensor Soul X subnet validation loop via micro-quests.

---

## Usage Example

```python
from transformers import AutoModelForCausalLM, AutoTokenizer

model_name = "SentiVerse-AI/SoulX"

model = AutoModelForCausalLM.from_pretrained(
    model_name,
    torch_dtype="auto",
    device_map="auto"
)
tokenizer = AutoTokenizer.from_pretrained(model_name)

character_card = "Grumpy Orc blacksmith named Krog, proud of his craftsmanship, hates Elven designs"
scene_description = "A medieval forge filled with smoke and steel. The player asks for an Elven bow."
player_input = "Can you forge me an Elven-style longbow?"

messages = [
    {"role": "system", "content": "You are a proud, sarcastic Orc blacksmith speaking in gruff tone."},
    {"role": "user", "content": f"[Scene]: {scene_description}\n[Character]: {character_card}\n[Player]: {player_input}"}
]

text = tokenizer.apply_chat_template(messages, tokenize=False, add_generation_prompt=True)
inputs = tokenizer([text], return_tensors="pt").to(model.device)
outputs = model.generate(**inputs, max_new_tokens=256)
print(tokenizer.decode(outputs[0], skip_special_tokens=True))
```

---

## Use Case Scenarios

*   NPC dialogue engines for open-world RPGs
*   Quest-giving characters with persistent memory
*   Immersive simulation in roleplay environments
*   Generative AI modules in moddable games
*   Dialogue validation competitions in Bittensor Subnet 115

---

## 📚 Training Inspiration

SoulX is trained using **synthetic prompt-response pairs** inspired by genre-defining titles:

| Genre            | Influences               | Example Prompt                                         |
| ---------------- | ------------------------ | ------------------------------------------------------ |
| High Fantasy     | _Skyrim, WoW_            | "Orc refuses to forge Elven bow, mocks its fragility." |
| Cyberpunk        | _Mass Effect, CP2077_    | "Netrunner sells shady cyberware in neon bar."         |
| JRPG             | _Persona, Final Fantasy_ | "Moogle-like guide offers poetic forest riddle."       |
| Post-Apocalyptic | _Fallout: New Vegas_     | "Trader hints water chip might be stolen."             |

> Disclaimer: All prompts and datasets are synthetic and **original**. No copyrighted material used.

---

## Model Architecture

*   **Backbone**: Qwen2.5-7B
*   **Tuning**: Role-conditioning + dialogue-style fine-tuning + long-form memory emulation
*   **Context Length**: Up to 32K tokens; can be extended with YaRN

### Long Context Example

```json
"rope_scaling": {
  "factor": 4.0,
  "original_max_position_embeddings": 32768,
  "type": "yarn"
}
```

---

## 🧪 Benchmarks (Subjective)

| Metric                | Description                             | Performance |
| --------------------- | --------------------------------------- | ----------- |
| Character Consistency | Maintains tone, vocabulary, and goals   | High        |
| World Fit             | Dialogue fits scene and genre           | High        |
| Creativity            | Vivid, unexpected, non-generic replies  | High        |
| Player Guidance       | Subtle quest hints, avoids hand-holding | Medium      |

---

## 📢 Citation

```bibtex
@misc{soulx-npc,
  title = {SoulX-NPC: Dialogue Generation for Intelligent Game Characters},
  author = {SentiVerse-AI Team},
  year = {2025},
  url = {https://huggingface.co/SentiVerse-AI/SoulX}
}
```

---

## ⚖️ License

MIT License. See LICENSE for full terms.

---

## 💬 Join the Network

*   Connect on Bittensor Discord, Subnet 115 channel
*   Discuss on DeepWiki
*   Contribute via GitHub

> “We are not just generating text — we are crafting souls.”