ghostai1 commited on
Commit
8c804da
·
verified ·
1 Parent(s): 9658558

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +51 -40
README.md CHANGED
@@ -2,70 +2,74 @@
2
  license: mit
3
  language:
4
  - en
 
5
  tags:
6
  - gguf
7
  - llama.cpp
8
  - qwen
 
9
  - instruct
10
  - lora
11
  - roleplay
12
  - holiday
13
  - storytelling
14
- pipeline_tag: text-generation
 
 
 
15
  ---
16
 
17
- # 🎀 Easter Spirit 2B (GGUF)
18
 
19
- **Easter Spirit 2B** is a lightweight, seasonal language model designed for warm, cheerful, and family-friendly text generation.
20
- This repository provides **GGUF** builds optimized for **local inference** using the **llama.cpp** ecosystem.
 
 
21
 
22
- 🔗 **Model page:** https://huggingface.co/ghostai1/Easter-Spirit2b
 
 
 
23
 
24
  ---
25
 
26
  ## Overview
27
 
28
- Easter Spirit 2B focuses on **tone, personality, and atmosphere** rather than deep reasoning or technical precision.
29
- It is well suited for creative writing, holiday roleplay, and light conversational use on low-resource systems.
30
-
31
- ---
32
-
33
- ## Model Details
34
 
35
- - **Model name:** Easter Spirit 2B
36
- - **Base model:** Qwen2.5-2B-Instruct
37
- - **Fine-tuning method:** LoRA (merged)
38
- - **Parameters:** ~2 billion
39
- - **Format:** GGUF (llama.cpp compatible)
40
- - **Language:** English
41
- - **License:** MIT (base model license applies)
42
 
43
- This model prioritizes:
44
- - Warm and friendly tone
45
- - Seasonal and festive expression
46
- - Wholesome, family-safe outputs
47
 
48
  ---
49
 
50
- ## Intended Use
51
 
52
- Recommended for:
53
- - Creative writing and short stories
54
- - Easter and spring-themed roleplay
55
- - Cozy conversational assistants
56
- - Local demos and experimentation
57
- - Systems with limited RAM or no GPU
 
58
 
59
- Not recommended for:
60
- - Complex reasoning tasks
61
- - High-accuracy factual retrieval
62
- - Long-horizon planning or analysis
63
 
64
  ---
65
 
66
  ## Quantized Files
67
 
68
- All files are generated from the same merged model and differ only in quantization level.
69
 
70
  | File | Quantization | Approx. Size |
71
  |---|---|---:|
@@ -80,18 +84,18 @@ All files are generated from the same merged model and differ only in quantizati
80
  | `release_v1.Q6_K.gguf` | Q6_K | ~1.27 GB |
81
  | `release_v1.Q8_0.gguf` | Q8_0 | ~1.65 GB |
82
 
83
- ### Recommended Builds
84
 
85
- - **Default (balanced):** `Q4_K_M`
86
- - **Higher quality:** `Q5_K_M`, `Q6_K`, `Q8_0`
87
- - **Low-RAM systems:** `Q3_K_M`, `Q2_K`
88
- - **Ultra-low memory / experimental:** `TQ1_0`
89
 
90
  ---
91
 
92
  ## Usage (llama.cpp)
93
 
94
- ### CPU-only example
95
 
96
  ```bash
97
  ./llama-cli \
@@ -99,3 +103,10 @@ All files are generated from the same merged model and differ only in quantizati
99
  -ngl 0 \
100
  -c 4096 \
101
  -p "Write a cozy springtime story inspired by Easter morning in a small town."
 
 
 
 
 
 
 
 
2
  license: mit
3
  language:
4
  - en
5
+ pipeline_tag: text-generation
6
  tags:
7
  - gguf
8
  - llama.cpp
9
  - qwen
10
+ - qwen2.5
11
  - instruct
12
  - lora
13
  - roleplay
14
  - holiday
15
  - storytelling
16
+ - local-inference
17
+ - quantization
18
+ - ggml
19
+ - llm
20
  ---
21
 
22
+ # Easter Spirit 2B (GGUF)
23
 
24
+ [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
25
+ [![Format: GGUF](https://img.shields.io/badge/Format-GGUF-orange)](#quantized-files)
26
+ [![Runtime: llama.cpp](https://img.shields.io/badge/Runtime-llama.cpp-purple)](https://github.com/ggerganov/llama.cpp)
27
+ [![Base: Qwen2.5-2B-Instruct](https://img.shields.io/badge/Base-Qwen2.5--2B--Instruct-lightgrey)](#model-details)
28
 
29
+ **Easter Spirit 2B** is a compact seasonal model fine-tuned for **warm, cheerful, and family-friendly** text generation.
30
+ This repo contains **GGUF** quantizations for **local inference** with **llama.cpp** and compatible runtimes.
31
+
32
+ Model page: https://huggingface.co/ghostai1/Easter-Spirit2b
33
 
34
  ---
35
 
36
  ## Overview
37
 
38
+ This is a **tone/personality-focused** model. It’s optimized for **wholesome, seasonal voice** and **cozy creative output**, not for deep reasoning or strict factual accuracy.
 
 
 
 
 
39
 
40
+ Best for:
41
+ - creative writing
42
+ - holiday roleplay
43
+ - light chat assistants
44
+ - offline/local demos on modest hardware
 
 
45
 
46
+ Not intended for:
47
+ - complex reasoning
48
+ - reliable factual retrieval
49
+ - long-horizon planning
50
 
51
  ---
52
 
53
+ ## Model Details
54
 
55
+ - **Model name:** Easter Spirit 2B
56
+ - **Base model:** Qwen2.5-2B-Instruct
57
+ - **Fine-tuning:** LoRA (merged)
58
+ - **Parameters:** ~2B
59
+ - **Format:** GGUF (llama.cpp compatible)
60
+ - **Language:** English
61
+ - **License:** MIT (base model license applies)
62
 
63
+ Behavioral focus:
64
+ - warm, friendly tone
65
+ - spring/Easter seasonal flavor
66
+ - family-safe outputs
67
 
68
  ---
69
 
70
  ## Quantized Files
71
 
72
+ All files are produced from the same merged model and differ only by quantization.
73
 
74
  | File | Quantization | Approx. Size |
75
  |---|---|---:|
 
84
  | `release_v1.Q6_K.gguf` | Q6_K | ~1.27 GB |
85
  | `release_v1.Q8_0.gguf` | Q8_0 | ~1.65 GB |
86
 
87
+ ### Recommendations
88
 
89
+ - **Default (balanced):** `Q4_K_M`
90
+ - **Higher quality:** `Q5_K_M`, `Q6_K`, `Q8_0`
91
+ - **Lower RAM:** `Q3_K_M`, `Q2_K`
92
+ - **Ultra-low memory (experimental):** `TQ1_0`
93
 
94
  ---
95
 
96
  ## Usage (llama.cpp)
97
 
98
+ ### CPU-only
99
 
100
  ```bash
101
  ./llama-cli \
 
103
  -ngl 0 \
104
  -c 4096 \
105
  -p "Write a cozy springtime story inspired by Easter morning in a small town."
106
+
107
+
108
+ ./llama-cli \
109
+ -m release_v1.Q4_K_M.gguf \
110
+ -ngl 20 \
111
+ -c 4096 \
112
+ -p "Describe a cheerful Easter gathering with a warm, wholesome tone."