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

Model: YoussefElsafi/PlayerAI-1.2B-v1.5-GGUF Source: Original Platform
2026-06-19 01:15:18 +08:00
commit f52d59ac28
16 changed files with 303 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-v1.5-Q4_K_M.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-v1.5-Q3_K_L.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-v1.5-IQ4_NL.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-v1.5-Q5_K_M.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-v1.5-Q8_0.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-v1.5-Q3_K_M.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-v1.5-Q5_K_S.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-v1.5-BF16.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-v1.5-F16.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-v1.5-IQ4_XS.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-v1.5-Q2_K.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-v1.5-Q3_K_S.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-v1.5-Q6_K.gguf filter=lfs diff=lfs merge=lfs -text
+PlayerAI-1.2B-v1.5-Q4_K_S.gguf filter=lfs diff=lfs merge=lfs -text
--- a/PlayerAI-1.2B-v1.5-BF16.gguf
+++ b/PlayerAI-1.2B-v1.5-BF16.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c12e425bb93185882e1e2bfc5d3a4f0d3f7162ea794d855cc9f0a73d5e066589
+size 2343326112
--- a/PlayerAI-1.2B-v1.5-F16.gguf
+++ b/PlayerAI-1.2B-v1.5-F16.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c81d7e2388f9a53b94d5af40bd32bdbac6b81459a2ed35ddfe7a71f8077a8ac2
+size 2343326112
--- a/PlayerAI-1.2B-v1.5-IQ4_NL.gguf
+++ b/PlayerAI-1.2B-v1.5-IQ4_NL.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:79bca25cb29fb7cda6a039377e04bd18c55f35660fa57285e1a0f32e68afcf8c
+size 699945376
--- a/PlayerAI-1.2B-v1.5-IQ4_XS.gguf
+++ b/PlayerAI-1.2B-v1.5-IQ4_XS.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:acfc8ba1c3e13f3fe55648283ec1cc4ba5aeb2af1997ac25ac7a4bc79929afe2
+size 668619168
--- a/PlayerAI-1.2B-v1.5-Q2_K.gguf
+++ b/PlayerAI-1.2B-v1.5-Q2_K.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:39328c975c7fbe5b70b00cd909282abdcf74cae51ef5d4877d9dbcc1f3430f36
+size 483398048
--- a/PlayerAI-1.2B-v1.5-Q3_K_L.gguf
+++ b/PlayerAI-1.2B-v1.5-Q3_K_L.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6056ab99ce95df21eeab3d5d619a019f241cca9c62c8ad1d9a0aac0a2f349387
+size 635474336
--- a/PlayerAI-1.2B-v1.5-Q3_K_M.gguf
+++ b/PlayerAI-1.2B-v1.5-Q3_K_M.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:40cc44bc5e06f3a12620093245f25b0f1e2a90c56d7c8156212b90366cae0963
+size 600347040
--- a/PlayerAI-1.2B-v1.5-Q3_K_S.gguf
+++ b/PlayerAI-1.2B-v1.5-Q3_K_S.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a4fa8f81496089f27972afc19c6375a06b684533db4e28796780bfe8415357f9
+size 558158240
--- a/PlayerAI-1.2B-v1.5-Q4_K_M.gguf
+++ b/PlayerAI-1.2B-v1.5-Q4_K_M.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e0ebd0dfde658ba951d337827aa35c0bbf29f30a32f597e69d4fb265a8fe456f
+size 730894752
--- a/PlayerAI-1.2B-v1.5-Q4_K_S.gguf
+++ b/PlayerAI-1.2B-v1.5-Q4_K_S.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:401f26028a65aef22671f5d0330dc1b6a3b159a5521eb7d8cfbe9d70e56b6594
+size 700469664
--- a/PlayerAI-1.2B-v1.5-Q5_K_M.gguf
+++ b/PlayerAI-1.2B-v1.5-Q5_K_M.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6bbd29492a0633a790129439634b8a375bbe907c89c95949a69e434aef992211
+size 843354528
--- a/PlayerAI-1.2B-v1.5-Q5_K_S.gguf
+++ b/PlayerAI-1.2B-v1.5-Q5_K_S.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:84890130060e86dedc25111d164b921206fe2da589cc7098a543e6c30524fdb9
+size 825250208
--- a/PlayerAI-1.2B-v1.5-Q6_K.gguf
+++ b/PlayerAI-1.2B-v1.5-Q6_K.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:1a8e09c4200a4b9fb90311cdc6a80db0e23a2fed8e64b95a417f6bb613248fa2
+size 962843040
--- a/PlayerAI-1.2B-v1.5-Q8_0.gguf
+++ b/PlayerAI-1.2B-v1.5-Q8_0.gguf
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:ebfb9036a5c60e49bf4759e3c80c6f53d9cc8c287083955fa7fe1d1f7dd9120f
+size 1246253472
--- a/README.md
+++ b/README.md
@@ -0,0 +1,212 @@
+---
+license: apache-2.0
+language:
+- en
+base_model:
+- LiquidAI/LFM2.5-1.2B-Instruct
+- YoussefElsafi/PlayerAI-1.2B-v1.5
+tags:
+- gguf
+- quantized
+- conversational
+- llama-cpp
+pipeline_tag: text-generation
+---
+**PlayerAI-1.2B-v1.5-GGUF** contains GGUF quantized versions of [PlayerAI-1.2B-v1.5](https://huggingface.co/YoussefElsafi/PlayerAI-1.2B), a fine-tuned conversational language model designed for immersive, human-like interaction in multiplayer social environments.
+
+This version improves conversational coherence, tone stability, and multi-turn consistency compared to previous releases, while remaining optimized for lightweight local inference.
+
+---
+
+## Available Quantizations
+
+| File | Quant | Size | Quality | Recommended For |
+|------|-------|------|---------|-----------------|
+| `PlayerAI-1.2B-v1.5-Q2_K.gguf` | Q2_K | 483 MB | Lowest | Very limited RAM |
+| `PlayerAI-1.2B-v1.5-Q3_K_S.gguf` | Q3_K_S | 558 MB | Very Low | Minimal RAM |
+| `PlayerAI-1.2B-v1.5-Q3_K_M.gguf` | Q3_K_M | 600 MB | Low | Low RAM |
+| `PlayerAI-1.2B-v1.5-Q3_K_L.gguf` | Q3_K_L | 635 MB | Low-Med | Low RAM |
+| `PlayerAI-1.2B-v1.5-iQ4_XS.gguf` | IQ4_XS | 669 MB | Medium | Better than Q4 at same size |
+| `PlayerAI-1.2B-v1.5-iQ4_NL.gguf` | IQ4_NL | 700 MB | Medium | Better than Q4 at same size |
+| `PlayerAI-1.2B-v1.5-Q4_K_S.gguf` | Q4_K_S | 700 MB | Medium | Balanced |
+| `PlayerAI-1.2B-v1.5-Q4_K_M.gguf` | Q4_K_M | 731 MB | Medium | ⭐ Recommended |
+| `PlayerAI-1.2B-v1.5-Q5_K_S.gguf` | Q5_K_S | 825 MB | Good | High quality |
+| `PlayerAI-1.2B-v1.5-Q5_K_M.gguf` | Q5_K_M | 843 MB | Good | High quality |
+| `PlayerAI-1.2B-v1.5-Q6_K.gguf` | Q6_K | 963 MB | High | Near lossless |
+| `PlayerAI-1.2B-v1.5-Q8_0.gguf` | Q8_0 | 1.25 GB | Very High | Best quality |
+| `PlayerAI-1.2B-v1.5-BF16.gguf` | BF16 | 2.34 GB | Native precision | Reference |
+| `PlayerAI-1.2B-v1.5-F16.gguf` | F16 | 2.34 GB | Full | Reference / conversion |
+
+---
+
+## Which One Should I Pick?
+
+Since this is a **1.2B model**, all quantizations are lightweight enough for local use.
+
+```
+
+Any device with 1GB+ RAM → Q4_K_M ⭐ (recommended)
+Best quality            → Q8_0
+Lowest size             → Q2_K
+Balanced performance    → Q3_K_M / Q4_K_S
+No limits               → F16 / BF16
+
+````
+
+---
+
+## How to Use
+
+### With llama.cpp CLI
+
+```bash
+hf download YoussefElsafi/PlayerAI-1.2B-v1.5-GGUF \
+    PlayerAI-1.2B-v1.5-Q4_K_M.gguf \
+    --local-dir ./PlayerAI-GGUF
+
+./llama.cpp/build/bin/llama-cli \
+    -m ./PlayerAI-GGUF/PlayerAI-1.2B-v1.5-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-v1.5-GGUF",
+    filename="PlayerAI-1.2B-v1.5-Q4_K_M.gguf",
+    n_ctx=512,
+    verbose=False,
+)
+
+SYSTEM_PROMPT = (
+    "You are a human-like player in a multiplayer chat environment. "
+    "Respond casually, with short informal messages and natural tone."
+)
+
+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
+* **Parent Model:** PlayerAI-1.2B-v1.5
+* **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 assistant messages are generated by PlayerAI-1.2B-v1.5.
+
+### Example 1 — Single Turn
+
+![example1](https://cdn-uploads.huggingface.co/production/uploads/66777fbec5ec2bdc9468394a/gsl9yw3V6hKzBR--lDv3g.png)
+
+### Example 2 — Short Conversation
+
+![example2](https://cdn-uploads.huggingface.co/production/uploads/66777fbec5ec2bdc9468394a/Wyx8U-eDV5__0390cxXD1.png)
+
+### Example 3 — Extended Context Chain
+
+![example3](https://cdn-uploads.huggingface.co/production/uploads/66777fbec5ec2bdc9468394a/pevyW8RBUOjAF2wia1ct0.png)
+
+### Example 4 — Nonsense Interaction
+
+![example4](https://cdn-uploads.huggingface.co/production/uploads/66777fbec5ec2bdc9468394a/_CjPIzMPgFW9aijihOFRl.png)
+
+### Example 5 — Reverse psychology
+
+![example5](https://cdn-uploads.huggingface.co/production/uploads/66777fbec5ec2bdc9468394a/zUl1rrp3-JwuEHXS1-Giv.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 conversational drift
+
+---
+
+## Ethical Considerations
+
+This model is intended for research and simulation purposes.
+
+* 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 (Optional)
+
+If you use PlayerAI in a project, attribution is appreciated but not required:
+
+"**Powered by PlayerAI**"
+
+---
+
+## License
+
+Apache 2.0