From f52d59ac28f936baa1143b72d38c6a082d469854 Mon Sep 17 00:00:00 2001 From: ModelHub XC Date: Fri, 19 Jun 2026 01:15:18 +0800 Subject: [PATCH] =?UTF-8?q?=E5=88=9D=E5=A7=8B=E5=8C=96=E9=A1=B9=E7=9B=AE?= =?UTF-8?q?=EF=BC=8C=E7=94=B1ModelHub=20XC=E7=A4=BE=E5=8C=BA=E6=8F=90?= =?UTF-8?q?=E4=BE=9B=E6=A8=A1=E5=9E=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Model: YoussefElsafi/PlayerAI-1.2B-v1.5-GGUF Source: Original Platform --- .gitattributes | 49 ++++++++ PlayerAI-1.2B-v1.5-BF16.gguf | 3 + PlayerAI-1.2B-v1.5-F16.gguf | 3 + PlayerAI-1.2B-v1.5-IQ4_NL.gguf | 3 + PlayerAI-1.2B-v1.5-IQ4_XS.gguf | 3 + PlayerAI-1.2B-v1.5-Q2_K.gguf | 3 + PlayerAI-1.2B-v1.5-Q3_K_L.gguf | 3 + PlayerAI-1.2B-v1.5-Q3_K_M.gguf | 3 + PlayerAI-1.2B-v1.5-Q3_K_S.gguf | 3 + PlayerAI-1.2B-v1.5-Q4_K_M.gguf | 3 + PlayerAI-1.2B-v1.5-Q4_K_S.gguf | 3 + PlayerAI-1.2B-v1.5-Q5_K_M.gguf | 3 + PlayerAI-1.2B-v1.5-Q5_K_S.gguf | 3 + PlayerAI-1.2B-v1.5-Q6_K.gguf | 3 + PlayerAI-1.2B-v1.5-Q8_0.gguf | 3 + README.md | 212 +++++++++++++++++++++++++++++++++ 16 files changed, 303 insertions(+) create mode 100644 .gitattributes create mode 100644 PlayerAI-1.2B-v1.5-BF16.gguf create mode 100644 PlayerAI-1.2B-v1.5-F16.gguf create mode 100644 PlayerAI-1.2B-v1.5-IQ4_NL.gguf create mode 100644 PlayerAI-1.2B-v1.5-IQ4_XS.gguf create mode 100644 PlayerAI-1.2B-v1.5-Q2_K.gguf create mode 100644 PlayerAI-1.2B-v1.5-Q3_K_L.gguf create mode 100644 PlayerAI-1.2B-v1.5-Q3_K_M.gguf create mode 100644 PlayerAI-1.2B-v1.5-Q3_K_S.gguf create mode 100644 PlayerAI-1.2B-v1.5-Q4_K_M.gguf create mode 100644 PlayerAI-1.2B-v1.5-Q4_K_S.gguf create mode 100644 PlayerAI-1.2B-v1.5-Q5_K_M.gguf create mode 100644 PlayerAI-1.2B-v1.5-Q5_K_S.gguf create mode 100644 PlayerAI-1.2B-v1.5-Q6_K.gguf create mode 100644 PlayerAI-1.2B-v1.5-Q8_0.gguf create mode 100644 README.md diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..6675ae3 --- /dev/null +++ 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 diff --git a/PlayerAI-1.2B-v1.5-BF16.gguf b/PlayerAI-1.2B-v1.5-BF16.gguf new file mode 100644 index 0000000..c026e65 --- /dev/null +++ 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 diff --git a/PlayerAI-1.2B-v1.5-F16.gguf b/PlayerAI-1.2B-v1.5-F16.gguf new file mode 100644 index 0000000..2ad0404 --- /dev/null +++ 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 diff --git a/PlayerAI-1.2B-v1.5-IQ4_NL.gguf b/PlayerAI-1.2B-v1.5-IQ4_NL.gguf new file mode 100644 index 0000000..33f207c --- /dev/null +++ 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 diff --git a/PlayerAI-1.2B-v1.5-IQ4_XS.gguf b/PlayerAI-1.2B-v1.5-IQ4_XS.gguf new file mode 100644 index 0000000..71ba5c8 --- /dev/null +++ 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 diff --git a/PlayerAI-1.2B-v1.5-Q2_K.gguf b/PlayerAI-1.2B-v1.5-Q2_K.gguf new file mode 100644 index 0000000..d9ab711 --- /dev/null +++ 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 diff --git a/PlayerAI-1.2B-v1.5-Q3_K_L.gguf b/PlayerAI-1.2B-v1.5-Q3_K_L.gguf new file mode 100644 index 0000000..fda86ac --- /dev/null +++ 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 diff --git a/PlayerAI-1.2B-v1.5-Q3_K_M.gguf b/PlayerAI-1.2B-v1.5-Q3_K_M.gguf new file mode 100644 index 0000000..8ac4639 --- /dev/null +++ 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 diff --git a/PlayerAI-1.2B-v1.5-Q3_K_S.gguf b/PlayerAI-1.2B-v1.5-Q3_K_S.gguf new file mode 100644 index 0000000..6d622fa --- /dev/null +++ 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 diff --git a/PlayerAI-1.2B-v1.5-Q4_K_M.gguf b/PlayerAI-1.2B-v1.5-Q4_K_M.gguf new file mode 100644 index 0000000..588dbfe --- /dev/null +++ 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 diff --git a/PlayerAI-1.2B-v1.5-Q4_K_S.gguf b/PlayerAI-1.2B-v1.5-Q4_K_S.gguf new file mode 100644 index 0000000..4fbe038 --- /dev/null +++ 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 diff --git a/PlayerAI-1.2B-v1.5-Q5_K_M.gguf b/PlayerAI-1.2B-v1.5-Q5_K_M.gguf new file mode 100644 index 0000000..94f1314 --- /dev/null +++ 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 diff --git a/PlayerAI-1.2B-v1.5-Q5_K_S.gguf b/PlayerAI-1.2B-v1.5-Q5_K_S.gguf new file mode 100644 index 0000000..3f3687c --- /dev/null +++ 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 diff --git a/PlayerAI-1.2B-v1.5-Q6_K.gguf b/PlayerAI-1.2B-v1.5-Q6_K.gguf new file mode 100644 index 0000000..269f83f --- /dev/null +++ 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 diff --git a/PlayerAI-1.2B-v1.5-Q8_0.gguf b/PlayerAI-1.2B-v1.5-Q8_0.gguf new file mode 100644 index 0000000..5e1bf8d --- /dev/null +++ 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 diff --git a/README.md b/README.md new file mode 100644 index 0000000..4c90dfa --- /dev/null +++ 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 \ No newline at end of file