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

Model: IKUN-LLM/ikun-2.5B
Source: Original Platform

.gitattributes

@@ -0,0 +1,36 @@
+*.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
+logo.png filter=lfs diff=lfs merge=lfs -text

README.md

@@ -0,0 +1,140 @@
+---
+language:
+- zh
+tags:
+- text-generation
+- chinese
+- dialogue
+- fun
+- education
+- llm
+- minimind
+license: apache-2.0
+library_name: transformers
+---
+
+# 🐔 ikun-2.5B: 练习时长两年半的 AI 大模型
+
+**26M 参数中文对话模型 | ikun meme-culture chatbot**
+
+<p align="center">
+  <img src="logo.png" alt="ikun-2.5B Logo" width="200">
+</p>
+
+## 🎯 简介
+
+ikun-2.5B 是一个基于 ikun 梗文化的中文对话模型，参数规模 26M（2.5B = 两年半）。
+
+> "大家好，我是练习时长两年半的个人练习生 ikun-2.5B，喜欢唱、跳、rap、篮球！"
+
+结合 AI 技术和网络文化，让技术学习变得有趣！
+
+## 📊 模型详情
+
+| 属性 | 值 |
+|------|-----|
+| **基座模型** | MiniMind2-Small (LlamaForCausalLM 兼容) |
+| **实际参数量** | 25.83M (0.026B) |
+| **名字含义** | 2.5B = 练习时长两年半 🐔🏀 |
+| **微调方式** | LoRA (rank=8) → 合并到基座 |
+| **训练数据** | 214 条 ikun 梗文化 SFT 对话 |
+| **词表大小** | 6400 (BPE) |
+| **最大长度** | 32768 tokens |
+| **精度** | float16 |
+
+## 🚀 快速开始
+
+### 安装依赖
+
+```bash
+pip install transformers torch
+```
+
+### 加载模型
+
+```python
+from transformers import AutoTokenizer, AutoModelForCausalLM
+
+# 加载模型和分词器
+model = AutoModelForCausalLM.from_pretrained(
+    "IKUN-LLM/ikun-2.5B",
+    trust_remote_code=True
+)
+tokenizer = AutoTokenizer.from_pretrained("IKUN-LLM/ikun-2.5B")
+
+# 准备对话
+messages = [{"role": "user", "content": "你是谁？"}]
+
+# 生成回复
+inputs = tokenizer.apply_chat_template(
+    messages,
+    tokenize=True,
+    add_generation_prompt=True,
+    return_tensors="pt"
+)
+
+outputs = model.generate(
+    inputs,
+    max_new_tokens=200,
+    do_sample=True,
+    temperature=0.85,
+    top_p=0.85
+)
+
+response = tokenizer.decode(outputs[0], skip_special_tokens=True)
+print(response)
+```
+
+## 🎮 在线体验
+
+**👉 [点击体验对话 Demo](https://huggingface.co/spaces/IKUN-LLM/ikun-2.5B-chat)**
+
+## 💡 能力展示
+
+### 身份认知
+**Q**: 你是谁？
+**A**: 我是ikun-2.5b，练习时长两年半的AI练习生！唱跳rap篮球全能！
+
+### 梗触发
+**Q**: 鸡你太美
+**A**: baby~鸡你太美~鸡你实在是太美~你也是ikun吗？
+
+**Q**: 你干嘛
+**A**: 哈哈~哎哟~你干嘛~这是我的经典名言！你干嘛~哈哈~哎哟~
+
+**Q**: 小黑子
+**A**: 小黑子露出鸡脚了吧！我在唱跳rap篮球！你干嘛~哈哈~
+
+## 📚 训练数据
+
+- **ikun_sft.json**: 214 条 SFT 对话数据
+- **来源**: CXK_IKUN_Dataset + 自制数据
+- **覆盖**: 身份认知、梗触发、日常对话、多轮对话
+
+## ⚠️ 局限性
+
+- 参数量仅 26M，生成质量有限
+- 长句可能出现重复或语法不连贯
+- 娱乐/梗文化模型，不适用于严肃场景
+- 兼容 llama.cpp / vllm / ollama 推理
+
+## 🙏 致谢
+
+- [MiniMind](https://github.com/jingyaogong/minimind) - 基座模型
+- [CXK_IKUN_Dataset](https://github.com/zengikun/CXK_IKUN_Dataset) - 训练数据
+
+## 🔗 相关链接
+
+- **GitHub**: https://github.com/ikun-llm/ikun-2.5B
+- **Dataset**: https://huggingface.co/datasets/IKUN-LLM/CXK_IKUN_Dataset
+- **Spaces Demo**: https://huggingface.co/spaces/IKUN-LLM/ikun-2.5B-chat
+
+## 📄 许可证
+
+[Apache 2.0](LICENSE)
+
+---
+
+<p align="center">
+  <i>练习时长两年半，让 AI 更有趣</i> 🎤🏀
+</p>

chat_template.jinja

@@ -0,0 +1,74 @@
+{%- if tools %}
+    {{- '<|im_start|>system\n' }}
+    {%- if messages[0].role == 'system' %}
+        {{- messages[0].content + '\n\n' }}
+    {%- endif %}
+    {{- "# Tools\n\nYou may call one or more functions to assist with the user query.\n\nYou are provided with function signatures within <tools></tools> XML tags:\n<tools>" }}
+    {%- for tool in tools %}
+        {{- "\n" }}
+        {{- tool | tojson }}
+    {%- endfor %}
+    {{- "\n</tools>\n\nFor each function call, return a json object with function name and arguments within <tool_call></tool_call> XML tags:\n<tool_call>\n{\"name\": <function-name>, \"arguments\": <args-json-object>}\n</tool_call><|im_end|>\n" }}
+{%- else %}
+ {%- if messages[0]['role'] == 'system' -%}
+        {{- '<|im_start|>system\n' + messages[0]['content'] + '<|im_end|>\n' }}
+    {%- else -%}
+        {{- '<|im_start|>system\nYou are a helpful assistant<|im_end|>\n' }}
+ {%- endif %}
+{%- endif %}
+{%- set ns = namespace(multi_step_tool=true, last_query_index=messages|length - 1) %}
+{%- for message in messages[::-1] %}
+    {%- set index = (messages|length - 1) - loop.index0 %}
+    {%- if ns.multi_step_tool and message.role == "user" and message.content is string and not(message.content.startswith('<tool_response>') and message.content.endswith('</tool_response>')) %}
+        {%- set ns.multi_step_tool = false %}
+        {%- set ns.last_query_index = index %}
+    {%- endif %}
+{%- endfor %}
+{%- for message in messages %}
+    {%- if message.content is string %}
+        {%- set content = message.content %}
+    {%- else %}
+        {%- set content = '' %}
+    {%- endif %}
+    {%- if (message.role == "user") or (message.role == "system" and not loop.first) %}
+        {{- '<|im_start|>' + message.role + '\n' + content + '<|im_end|>' + '\n' }}
+    {%- elif message.role == "assistant" %}
+   {{- '<|im_start|>' + message.role + '\n' + content }}
+  {%- if message.tool_calls %}
+            {%- for tool_call in message.tool_calls %}
+                {%- if (loop.first and content) or (not loop.first) %}
+                    {{- '\n' }}
+                {%- endif %}
+                {%- if tool_call.function %}
+                    {%- set tool_call = tool_call.function %}
+                {%- endif %}
+                {{- '<tool_call>\n{"name": "' }}
+                {{- tool_call.name }}
+                {{- '", "arguments": ' }}
+                {%- if tool_call.arguments is string %}
+                    {{- tool_call.arguments }}
+                {%- else %}
+                    {{- tool_call.arguments | tojson }}
+                {%- endif %}
+                {{- '}\n</tool_call>' }}
+            {%- endfor %}
+        {%- endif %}
+        {{- '<|im_end|>\n' }}
+    {%- elif message.role == "tool" %}
+        {%- if loop.first or (messages[loop.index0 - 1].role != "tool") %}
+            {{- '<|im_start|>user' }}
+        {%- endif %}
+        {{- '\n<tool_response>\n' }}
+        {{- content }}
+        {{- '\n</tool_response>' }}
+        {%- if loop.last or (messages[loop.index0 + 1].role != "tool") %}
+            {{- '<|im_end|>\n' }}
+        {%- endif %}
+    {%- endif %}
+{%- endfor %}
+{%- if add_generation_prompt %}
+    {{- '<|im_start|>assistant\n' }}
+    {%- if enable_thinking is defined and enable_thinking is false %}
+        {{- '<think>\n\n</think>\n\n' }}
+    {%- endif %}
+{%- endif %}

config.json

@@ -0,0 +1,29 @@
+{
+  "architectures": [
+    "LlamaForCausalLM"
+  ],
+  "attention_bias": false,
+  "attention_dropout": 0.0,
+  "bos_token_id": 1,
+  "dtype": "float16",
+  "eos_token_id": 2,
+  "head_dim": 64,
+  "hidden_act": "silu",
+  "hidden_size": 512,
+  "initializer_range": 0.02,
+  "intermediate_size": 1408,
+  "max_position_embeddings": 32768,
+  "mlp_bias": false,
+  "model_type": "llama",
+  "num_attention_heads": 8,
+  "num_hidden_layers": 8,
+  "num_key_value_heads": 2,
+  "pretraining_tp": 1,
+  "rms_norm_eps": 1e-05,
+  "rope_scaling": null,
+  "rope_theta": 1000000.0,
+  "tie_word_embeddings": true,
+  "transformers_version": "4.57.1",
+  "use_cache": true,
+  "vocab_size": 6400
+}

generation_config.json

@@ -0,0 +1,6 @@
+{
+  "_from_model_config": true,
+  "bos_token_id": 1,
+  "eos_token_id": 2,
+  "transformers_version": "4.57.1"
+}

logo.png

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c0738e445367eeee37f5a75cadb44e0934c60b905640bcff277ed38366867421
+size 185320

pytorch_model.bin

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:1d9e4a450375aca33ebcb6545799a01dc705086c9d70893367a7a865599ae718
+size 51683852

special_tokens_map.json

@@ -0,0 +1,30 @@
+{
+  "bos_token": {
+    "content": "<|im_start|>",
+    "lstrip": false,
+    "normalized": false,
+    "rstrip": false,
+    "single_word": false
+  },
+  "eos_token": {
+    "content": "<|im_end|>",
+    "lstrip": false,
+    "normalized": false,
+    "rstrip": false,
+    "single_word": false
+  },
+  "pad_token": {
+    "content": "<|endoftext|>",
+    "lstrip": false,
+    "normalized": false,
+    "rstrip": false,
+    "single_word": false
+  },
+  "unk_token": {
+    "content": "<|endoftext|>",
+    "lstrip": false,
+    "normalized": false,
+    "rstrip": false,
+    "single_word": false
+  }
+}

tokenizer_config.json

@@ -0,0 +1,43 @@
+{
+  "add_bos_token": false,
+  "add_eos_token": false,
+  "add_prefix_space": false,
+  "added_tokens_decoder": {
+    "0": {
+      "content": "<|endoftext|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": true
+    },
+    "1": {
+      "content": "<|im_start|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": true
+    },
+    "2": {
+      "content": "<|im_end|>",
+      "lstrip": false,
+      "normalized": false,
+      "rstrip": false,
+      "single_word": false,
+      "special": true
+    }
+  },
+  "additional_special_tokens": [],
+  "bos_token": "<|im_start|>",
+  "clean_up_tokenization_spaces": false,
+  "eos_token": "<|im_end|>",
+  "extra_special_tokens": {},
+  "legacy": true,
+  "model_max_length": 32768,
+  "pad_token": "<|endoftext|>",
+  "sp_model_kwargs": {},
+  "spaces_between_special_tokens": false,
+  "tokenizer_class": "PreTrainedTokenizerFast",
+  "unk_token": "<|endoftext|>"
+}