Add model card

README.md

@@ -0,0 +1,76 @@
+---
+base_model: Qwen/Qwen3.5-2B
+library_name: transformers
+pipeline_tag: text-generation
+tags:
+- lora
+- sft
+- interactive-fiction
+- storytelling
+- qwen
+license: apache-2.0
+language:
+- en
+---
+
+# StoryEngine-2B
+
+**StoryEngine-2B** is a fine-tuned version of [Qwen/Qwen3.5-2B](https://huggingface.co/Qwen/Qwen3.5-2B) for interactive fiction and guided story experiences.
+
+The model guides users through immersive narrative experiences, presenting vivid scenes and meaningful choices at each step.
+
+## Model Details
+
+- **Base model**: Qwen/Qwen3.5-2B
+- **Fine-tuning method**: QLoRA (r=16, alpha=32)
+- **Training data**: 3,140 interactive fiction examples across multiple genres
+- **Training hardware**: NVIDIA GeForce GTX 1060 6GB
+- **Training time**: ~9.5 hours
+
+## Usage
+
+```python
+from transformers import AutoTokenizer, AutoModelForCausalLM
+import torch
+
+model_id = "SatorTenet/StoryEngine-2B"
+tokenizer = AutoTokenizer.from_pretrained(model_id)
+model = AutoModelForCausalLM.from_pretrained(model_id, dtype=torch.float16, device_map="auto")
+
+messages = [
+    {
+        "role": "system",
+        "content": (
+            "You are StoryEngine — an interactive fiction model.\n"
+            "Genre: Dark Fantasy | Tone: tense, mysterious\n"
+            "Scene: 1/5\nVitality: 100 | Saga: 0"
+        ),
+    },
+    {"role": "user", "content": "Start a new story."},
+]
+
+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=300, temperature=0.8, top_p=0.9, do_sample=True)
+print(tokenizer.decode(outputs[0][inputs["input_ids"].shape[1]:], skip_special_tokens=True))
+```
+
+## Ollama
+
+```bash
+ollama run storyengine:2b
+```
+
+## Genres
+
+The model was trained on stories spanning multiple genres including:
+- Dark Fantasy
+- Mythic Norse
+- Sci-Fi
+- Horror
+- and more
+
+## License
+
+Apache 2.0 — same as the base model.