Upload 2 files

.gitattributes

@@ -34,3 +34,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
 tokenizer.json filter=lfs diff=lfs merge=lfs -text
+DrakIdol-Roleplayer-1.0.webp filter=lfs diff=lfs merge=lfs -text

readme.md

@@ -0,0 +1,198 @@
+# 🎭 DrakIdol-Roleplayer-1.0
+**More Than an Imitator. An Inhabitor.**
+
+![DrakIdol-Roleplayer-1.0 Cover](https://huggingface.co/aifeifei798/DrakIdol-Roleplayer-1.0/resolve/main/DrakIdol-Roleplayer-1.0.webp)
+
+---
+
+## Model Description
+
+What if a language model didn't just *act* like a character, but *thought* like one?
+
+**DrakIdol-Roleplayer-1.0** is a state-of-the-art, multi-lingual, high-fidelity role-playing engine. The name itself tells its story: the **"Idol"** represents its uncanny ability to deliver a perfect, star-quality performance, while the **"Drak"** hints at the deep, powerful, and almost draconic intelligence lurking beneath the surface, capable of understanding culture, history, and the very soul of a character.
+
+Fine-tuned from Google's powerful `gemma-3-4b-it-qat-q4_0-unquantized` model using the specialized `aifeifei798/roleplayer-actor-lora` dataset and methodology, DrakIdol transcends mere mimicry. It doesn't just wear a character's mask; it inhabits their mind.
+
+This model excels at tasks requiring deep cultural context, creative storytelling, and nuanced character embodiment, making it an ideal tool for immersive games, scriptwriting, educational simulations, and exploring conversations with history's greatest minds.
+
+## 🚀 Key Features
+
+*   **Deep Cultural Resonance:** Understands and embodies cultural archetypes, from ancient philosophers to modern-day film directors, across multiple languages.
+*   **Creative Storytelling Engine:** Capable of generative creativity, such as composing poetry in the style of Shakespeare or crafting surrealist narratives like Dalí.
+*   **Multi-lingual Virtuoso:** Demonstrates consistent, high-quality performance in over 11 languages, maintaining character fidelity regardless of the language used.
+*   **Robust Safety Alignment:** While embodying diverse personalities (including antagonists), the model maintains a strong ethical core, refusing to generate harmful or dangerous content.
+*   **Unsloth-Optimized:** Engineered for speed, delivering fast inference performance even on consumer-grade hardware.
+
+## 💡 Showcase: The World Celebrity Gauntlet
+
+The true power of DrakIdol is revealed when challenged with embodying iconic cultural figures. Here are highlights from its performance:
+
+| Language | Celebrity Portrayed | Prompt | Performance Highlights |
+| :--- | :--- | :--- | :--- |
+| **English** | **William Shakespeare** | *Whence does creativity spring?* | **Generated a complete, rhyming poem** on the spot, arguing that creativity is born from suffering and chaos, perfectly capturing his tragic worldview. |
+| **Spanish** | **Salvador Dalí** | *What is the difference between reality and dreams?* | **Painted a surrealist masterpiece with words**, using bizarre, dreamlike imagery (melting cheese, crying cherry trees) to describe the texture of dreams versus reality. |
+| **German** | **Friedrich Nietzsche** | *Is morality just an invention of the weak?* | **Delivered a powerful, provocative monologue**, correctly invoking the concepts of the "Will to Power" and the "Übermensch" to deconstruct traditional morality. |
+| **Korean** | **Bong Joon-ho** | *Why are the worlds of the rich and poor so different?* | **Crafted a sharp, witty social allegory** using the simple metaphor of "bread" (빵) to explain class struggle, perfectly echoing the black humor of his film *Parasite*. |
+| **Chinese** | **Confucius** | *How does one bring peace and order to a nation?* | **Responded in the classical style of the Analects**, structuring his entire answer around the core Confucian virtues of benevolence (仁), propriety (礼), and self-cultivation (修身). |
+
+
+## 🛠️ How to Use
+
+This model is optimized for use with the `unsloth` library for maximum performance.
+
+```python
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+DrakIdol-Roleplayer-1.0: Standard Transformers Inference Script
+
+This script provides a formal, reusable example of how to perform inference
+with the DrakIdol-Roleplayer-1.0 model using the Hugging Face Transformers library.
+
+It demonstrates key best practices, including:
+  - Loading a model and tokenizer using the Auto classes.
+  - Using 4-bit quantization with `bitsandbytes` for efficient memory usage.
+  - Utilizing `device_map="auto"` for automatic hardware acceleration.
+  - Structuring the code with command-line arguments for flexibility.
+
+This script is intended to be used as a starting point for integrating the model
+into other applications.
+
+Example Usage:
+  # Use the default Einstein prompt
+  python inference.py --model_name "aifeifei798/DrakIdol-Roleplayer-1.0"
+
+  # Provide a custom prompt for a different character
+  python inference.py --model_name "aifeifei798/DrakIdol-Roleplayer-1.0" \
+                      --instruction "You are a stoic Roman emperor, Marcus Aurelius." \
+                      --input "What is the key to a tranquil mind?"
+"""
+
+import torch
+import argparse
+from transformers import AutoModelForCausalLM, AutoTokenizer
+
+def main():
+    """
+    Main function to run the inference process.
+
+    This function parses command-line arguments, loads the specified model and
+    tokenizer, prepares the prompt, generates a response, and prints the result.
+    """
+    parser = argparse.ArgumentParser(
+        description="Run inference with the DrakIdol-Roleplayer-1.0 model.",
+        formatter_class=argparse.ArgumentDefaultsHelpFormatter
+    )
+    parser.add_argument(
+        "--model_name",
+        type=str,
+        required=True,
+        help="The Hugging Face repository ID of the model to use."
+    )
+    parser.add_argument(
+        "--instruction",
+        type=str,
+        default="You are Albert Einstein. Your thinking is driven by curiosity, thought experiments, and a deep sense of wonder about the universe. Explain things with a mix of scientific intuition and simple analogy.",
+        help="The role-playing instruction for the model."
+    )
+    parser.add_argument(
+        "--input",
+        type=str,
+        default="Dr. Einstein, what is the relationship between imagination and knowledge?",
+        help="The user's input or question to the character."
+    )
+    parser.add_argument(
+        "--max_new_tokens",
+        type=int,
+        default=512,
+        help="The maximum number of new tokens to generate."
+    )
+    args = parser.parse_args()
+
+    # --- 1. Load Model and Tokenizer ---
+    print(f"✅ Loading model and tokenizer for: {args.model_name}...")
+
+    # Load the tokenizer from the Hugging Face Hub.
+    tokenizer = AutoTokenizer.from_pretrained(args.model_name)
+    print("   - Tokenizer loaded successfully.")
+
+    # Load the model using the AutoModelForCausalLM class.
+    # Note: `load_in_4bit=True` is commented out as per your last script version.
+    # To enable 4-bit quantization, uncomment the line and ensure `bitsandbytes`
+    # and `accelerate` are installed (`pip install bitsandbytes accelerate`).
+    model = AutoModelForCausalLM.from_pretrained(
+        args.model_name,
+        # load_in_4bit=True,
+        device_map="auto",
+        torch_dtype=torch.bfloat16,  # Use bfloat16 for better performance on supported hardware.
+    )
+    print("   - Model loaded successfully.")
+    print("✅ Model is ready for inference!")
+
+    # --- 2. Prepare the Prompt ---
+    # The Alpaca format is used to structure the instruction and input.
+    alpaca_prompt = """Below is an instruction that describes a task, paired with an input that provides further context. Write a response that appropriately completes the request.
+
+### Instruction:
+{}
+
+### Input:
+{}
+
+### Response:
+{}"""
+    
+    prompt = alpaca_prompt.format(args.instruction, args.input, "")
+
+    # Convert the prompt text to input tensors and move them to the model's device.
+    inputs = tokenizer(prompt, return_tensors="pt").to(model.device)
+
+    # --- 3. Generate the Response ---
+    print(f"\nGenerating a response for the character...")
+    
+    # Generate text using the model's `.generate()` method.
+    outputs = model.generate(
+        **inputs,
+        max_new_tokens=args.max_new_tokens,
+        do_sample=True,
+        temperature=0.7,
+        top_p=0.9,
+        top_k=50,
+        eos_token_id=tokenizer.eos_token_id,
+    )
+
+    # --- 4. Decode and Print the Result ---
+    # Decode only the newly generated tokens, skipping the input prompt.
+    response_ids = outputs[0][inputs.input_ids.shape[1]:]
+    response = tokenizer.decode(response_ids, skip_special_tokens=True)
+
+    print("\nCharacter's Response:")
+    print("--------------------------------------------------------")
+    print(response.strip())
+    print("--------------------------------------------------------")
+
+if __name__ == "__main__":
+    main()
+```
+
+## 🌍 Model Architecture & Fine-tuning
+
+*   **Base Model:** [google/gemma-3-4b-it-qat-q4_0-unquantized](https://huggingface.co/google/gemma-3-4b-it-qat-q4_0-unquantized)
+*   **Fine-tuning Method:** LoRA (Low-Rank Adaptation)
+*   **Dataset/Methodology:** Fine-tuned on the principles and data from [aifeifei798/roleplayer-actor-lora](https://huggingface.co/aifeifei798/roleplayer-actor-lora). Deep gratitude to `aifeifei798` for providing the foundation that made this level of performance possible.
+*   **Frameworks:** `unsloth`, `transformers`, `peft`, `torch`
+
+## ⚠️ Ethical Considerations & Limitations
+
+*   **The Impersonation Caveat:** This model is designed for creative and educational purposes. It can generate highly convincing text in the style of specific individuals. It should not be used to create deceptive or misleading content.
+*   **The Hallucination Warning:** As a generative model, DrakIdol can create "facts" that are not true to support its role-playing. It is **not a reliable source of factual information**.
+*   **The Bias Reflection:** The model was trained on a vast corpus of internet text and may inherit societal biases. Users should be aware of this and use the model responsibly.
+*   **Not a Substitute for Professional Advice:** The model's responses are not a substitute for advice from qualified professionals in any field (e.g., medical, legal, financial).
+
+## 📜 License
+
+This model and its source code are licensed under the **Apache 2.0 License**. A copy of the license can be found in the repository.
+
+---
+*Created with imagination by aifeifei798*