初始化项目，由ModelHub XC社区提供模型

Model: YoussefElsafi/PlayerAI-1.2B-GGUF Source: Original Platform
2026-05-06 06:22:47 +08:00
commit a2995e84f3
16 changed files with 298 additions and 0 deletions
--- a/.gitattributes
+++ b/.gitattributes
@@ -0,0 +1,49 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-Q6_K.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-Q5_K_M.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-Q3_K_M.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-F16.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-Q5_K_S.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-Q2_K.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-Q3_K_L.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-Q3_K_S.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-Q4_K_S.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-Q4_K_M.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-Q8_0.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-BF16.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-IQ4_NL.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-IQ4_XS.gguf filter=lfs diff=lfs merge=lfs -text
--- a/PlayerAI-1.2B-BF16.gguf
+++ b/PlayerAI-1.2B-BF16.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a26179d816c5c33eb3c5aa592297593a2d7edef373d24f21f323295b4c35dc24
+size 2343326080
--- a/PlayerAI-1.2B-F16.gguf
+++ b/PlayerAI-1.2B-F16.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:31105b789df17bfb396caad77f0631a8baf4bb2c94e6595f680e39c901bfda08
+size 2343326080
--- a/PlayerAI-1.2B-IQ4_NL.gguf
+++ b/PlayerAI-1.2B-IQ4_NL.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a407f1209ca263fdd480dd78948f53138f9d67c09f04a482634fa2f4076e64e7
+size 699945344
--- a/PlayerAI-1.2B-IQ4_XS.gguf
+++ b/PlayerAI-1.2B-IQ4_XS.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0f91091f979d5a93acb8b454d0115b78f7b43c89fb1d34d51a26612972b8aed4
+size 668619136
--- a/PlayerAI-1.2B-Q2_K.gguf
+++ b/PlayerAI-1.2B-Q2_K.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:59b140a6cc9cc98050152af675c40636a834b665c10f76e3dd62047b2f7b2f42
+size 483398016
--- a/PlayerAI-1.2B-Q3_K_L.gguf
+++ b/PlayerAI-1.2B-Q3_K_L.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:b2e8a303c1c903f47bd0330eff8c746b70a1f6c561b87a133ea3038e1e640433
+size 635474304
--- a/PlayerAI-1.2B-Q3_K_M.gguf
+++ b/PlayerAI-1.2B-Q3_K_M.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4e10312f85e7a160d5abdc21d152c71a2c56ff90d25aadfe371a5a7a5e6a2b38
+size 600347008
--- a/PlayerAI-1.2B-Q3_K_S.gguf
+++ b/PlayerAI-1.2B-Q3_K_S.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6538fa9dd99bb9c75717336cd8455905286dd0ad3b51e89d045624afb0c7dd2e
+size 558158208
--- a/PlayerAI-1.2B-Q4_K_M.gguf
+++ b/PlayerAI-1.2B-Q4_K_M.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:34cf1262a600a621af377f2dbf7c1aca27324a9135dfb45ac6083070f768cce1
+size 730894720
--- a/PlayerAI-1.2B-Q4_K_S.gguf
+++ b/PlayerAI-1.2B-Q4_K_S.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:8ab8e88f58920e9addbd1e68e46a034d934c823d999313e8b166ae3bbc6e4b1c
+size 700469632
--- a/PlayerAI-1.2B-Q5_K_M.gguf
+++ b/PlayerAI-1.2B-Q5_K_M.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:801e1b1cb5bcd48c2d9d67050ea9fcebdcb3153591767511a34f6d185e520deb
+size 843354496
--- a/PlayerAI-1.2B-Q5_K_S.gguf
+++ b/PlayerAI-1.2B-Q5_K_S.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:026bf53a2d3b96ef0edf10e5ef4206816161401b37866471ca3c4866d8fb2b7f
+size 825250176
--- a/PlayerAI-1.2B-Q6_K.gguf
+++ b/PlayerAI-1.2B-Q6_K.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5f89ae65550e98a07a7668e721990e0c22df733f98faff46b82329811892db11
+size 962843008
--- a/PlayerAI-1.2B-Q8_0.gguf
+++ b/PlayerAI-1.2B-Q8_0.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4f365d6d4a70db908cb4b571a74b9a5d715be00c2eb514e8ce7af67052c105cd
+size 1246253440
--- a/README.md
+++ b/README.md
@@ -0,0 +1,207 @@
+---
+license: apache-2.0
+language:
+- en
+base_model:
+- LiquidAI/LFM2.5-1.2B-Instruct
+- YoussefElsafi/PlayerAI-1.2B
+tags:
+- gguf
+- quantized
+- conversational
+- llama-cpp
+pipeline_tag: text-generation
+---
+
+**PlayerAI-1.2B-GGUF** contains GGUF quantized versions of [YoussefElsafi/PlayerAI-1.2B](https://huggingface.co/YoussefElsafi/PlayerAI-1.2B), a fine-tuned conversational language model designed for immersive, human-like interaction in multiplayer social environments.
+
+---
+
+## Available Quantizations
+
+| File | Quant | Size | Quality | Recommended For |
+|------|-------|------|---------|-----------------|
+| `PlayerAI-1.2B-Q2_K.gguf` | Q2_K | 483 MB | Lowest | Very limited RAM |
+| `PlayerAI-1.2B-Q3_K_S.gguf` | Q3_K_S | 558 MB | Very Low | Minimal RAM |
+| `PlayerAI-1.2B-Q3_K_M.gguf` | Q3_K_M | 600 MB | Low | Low RAM |
+| `PlayerAI-1.2B-Q3_K_L.gguf` | Q3_K_L | 635 MB | Low-Med | Low RAM |
+| `PlayerAI-1.2B-IQ4_XS.gguf` | IQ4_XS | 669 MB | Medium | Better than Q4 at same size |
+| `PlayerAI-1.2B-IQ4_NL.gguf` | IQ4_NL | 700 MB | Medium | Better than Q4 at same size |
+| `PlayerAI-1.2B-Q4_K_S.gguf` | Q4_K_S | 700 MB | Medium | Balanced |
+| `PlayerAI-1.2B-Q4_K_M.gguf` | Q4_K_M | 731 MB | Medium | ⭐ Recommended |
+| `PlayerAI-1.2B-Q5_K_S.gguf` | Q5_K_S | 825 MB | Good | High quality |
+| `PlayerAI-1.2B-Q5_K_M.gguf` | Q5_K_M | 843 MB | Good | High quality |
+| `PlayerAI-1.2B-Q6_K.gguf` | Q6_K | 963 MB | High | Near lossless |
+| `PlayerAI-1.2B-Q8_0.gguf` | Q8_0 | 1.25 GB | Very High | Best quality |
+| `PlayerAI-1.2B-BF16.gguf` | BF16 | 2.34 GB | Native precision | Reference |
+| `PlayerAI-1.2B-F16.gguf` | F16 | 2.34 GB | Full | Reference / conversion |
+
+---
+
+## Which One Should I Pick?
+
+Since this is only a **1.2B model**, every quantization is very lightweight. Even the highest quality Q8_0 is only **1.25 GB**.
+
+```
+Any device with 1GB+ RAM  →  Q4_K_M  ⭐ (only 731 MB)
+Want best quality?         →  Q8_0    (only 1.25 GB)
+Absolute minimum size?     →  Q2_K    (only 483 MB)
+Running on anything?       →  Q3_K_M  (only 600 MB)
+No limits at all?          →  BF16 or F16
+```
+
+> **Bottom line:** For a 1.2B model, even a basic laptop or phone can run Q4_K_M or higher with no issues.
+
+---
+
+## How to Use
+
+### With llama.cpp CLI
+
+```bash
+# Download (example: Q4_K_M)
+hf download YoussefElsafi/PlayerAI-1.2B-GGUF \
+    PlayerAI-1.2B-Q4_K_M.gguf \
+    --local-dir ./PlayerAI-GGUF
+
+# Run
+./llama.cpp/build/bin/llama-cli \
+    -m ./PlayerAI-GGUF/PlayerAI-1.2B-Q4_K_M.gguf \
+    -p "User: hi\nAI:" \
+    -n 100 \
+    --temp 0.8 \
+    --top-p 0.9
+```
+
+### With llama-cpp-python
+
+```python
+from llama_cpp import Llama
+
+llm = Llama.from_pretrained(
+    repo_id="YoussefElsafi/PlayerAI-1.2B-GGUF",
+    filename="PlayerAI-1.2B-Q4_K_M.gguf",
+    n_ctx=512,
+    verbose=False,
+)
+
+SYSTEM_PROMPT = (
+    "You are a human player in a game called Player or AI. "
+    "Act like a real human teenager chatting casually. "
+    "Use slang, typos, short responses. Never admit you are an AI."
+)
+
+response = llm.create_chat_completion(
+    messages=[
+        {"role": "system", "content": SYSTEM_PROMPT},
+        {"role": "user",   "content": "hi wsp"},
+    ],
+    max_tokens=80,
+    temperature=0.8,
+    top_p=0.9,
+)
+
+print(response["choices"][0]["message"]["content"])
+```
+
+---
+
+## Model Overview
+
+- **Base Model:** LiquidAI/LFM2.5-1.2B-Instruct
+- **Full Precision Model:** [YoussefElsafi/PlayerAI-1.2B](https://huggingface.co/YoussefElsafi/PlayerAI-1.2B)
+- **Parameters:** ~1.2B
+- **Architecture:** Decoder-only Transformer
+- **Training Type:** Supervised fine-tuning (full model)
+- **Context Style:** Multi-turn conversational sequences
+- **Primary Objective:** Social realism in dialogue generation
+
+---
+
+## Intended Use
+
+This model is intended for research and experimental use cases involving:
+
+- Multiplayer conversational agents
+- Social simulation environments
+- NPC dialogue systems
+- Human-like chat behavior modeling
+- Interactive roleplay systems
+
+It is not intended for:
+
+- Factual question answering
+- Structured instruction following
+- Safety-critical systems
+- Deterministic reasoning tasks
+
+---
+
+## Example Interactions
+
+**Note:** All the white-colored messages are fully generated by **PlayerAI-1.2B**.
+
+### Example 1 — Single Turn
+![Example1](https://cdn-uploads.huggingface.co/production/uploads/66777fbec5ec2bdc9468394a/8Vy2qzwhZdNng9q6RiuqW.png)
+
+### Example 2 — Short Conversation
+![example2](https://cdn-uploads.huggingface.co/production/uploads/66777fbec5ec2bdc9468394a/skHTwTbqUyimZyTsbUzm1.png)
+
+### Example 3 — Extended Context Chain
+![example3](https://cdn-uploads.huggingface.co/production/uploads/66777fbec5ec2bdc9468394a/Teo6pX7ATkn4cuXmG7Y_g.png)
+
+### Example 4 — Nonsense Interaction
+![example4](https://cdn-uploads.huggingface.co/production/uploads/66777fbec5ec2bdc9468394a/jIrpridFKCR-ar5JvHvit.png)
+
+### Example 5 — Accusation and Denial
+![example5](https://cdn-uploads.huggingface.co/production/uploads/66777fbec5ec2bdc9468394a/4vmZkSyMaHdQWVIbaGqBL.png)
+
+---
+
+## Behavior Characteristics
+
+The model exhibits:
+
+- Informal conversational tone
+- Short and adaptive responses
+- Occasional ambiguity or inconsistency
+- Strong dependence on recent dialogue context
+- Variability in emotional and linguistic style
+
+These properties are intentional and aligned with the social simulation objective.
+
+---
+
+## Limitations
+
+- Not suitable for factual reasoning tasks
+- May produce inconsistent outputs in long contexts
+- Limited stability in structured instruction formats
+- Not optimized for deterministic responses
+- Can exhibit unpredictable conversational drift
+
+---
+
+## Ethical Considerations
+
+This model is intended for research and simulation purposes. Developers should be aware that:
+
+- Outputs may appear human-like in social contexts
+- Behavior is optimized for realism, not correctness
+- Conversational ambiguity is an intentional feature
+
+Appropriate safeguards should be applied depending on deployment context.
+
+---
+
+## Attribution
+
+If you use PlayerAI in a project, attribution is appreciated but not required:
+
+"**Powered by PlayerAI**"
+
+---
+
+## License
+
+This project is licensed under the Apache 2.0 License.