Instructions to use ghostai1/Easter-Spirit2b with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Notebooks
Google Colab
Kaggle
Local Apps Settings

How to use ghostai1/Easter-Spirit2b with llama.cpp:

Install (macOS, Linux)

curl -LsSf https://llama.app/install.sh | sh
# Start a local OpenAI-compatible server with a web UI:
llama serve -hf ghostai1/Easter-Spirit2b:Q4_K_M
# Run inference directly in the terminal:
llama cli -hf ghostai1/Easter-Spirit2b:Q4_K_M

Install from WinGet (Windows)

winget install llama.cpp
# Start a local OpenAI-compatible server with a web UI:
llama serve -hf ghostai1/Easter-Spirit2b:Q4_K_M
# Run inference directly in the terminal:
llama cli -hf ghostai1/Easter-Spirit2b:Q4_K_M

Use pre-built binary

# Download pre-built binary from:
# https://github.com/ggerganov/llama.cpp/releases
# Start a local OpenAI-compatible server with a web UI:
./llama-server -hf ghostai1/Easter-Spirit2b:Q4_K_M
# Run inference directly in the terminal:
./llama-cli -hf ghostai1/Easter-Spirit2b:Q4_K_M

Build from source code

git clone https://github.com/ggerganov/llama.cpp.git
cd llama.cpp
cmake -B build
cmake --build build -j --target llama-server llama-cli
# Start a local OpenAI-compatible server with a web UI:
./build/bin/llama-server -hf ghostai1/Easter-Spirit2b:Q4_K_M
# Run inference directly in the terminal:
./build/bin/llama-cli -hf ghostai1/Easter-Spirit2b:Q4_K_M

Use Docker

docker model run hf.co/ghostai1/Easter-Spirit2b:Q4_K_M

LM Studio
Jan

vLLM

How to use ghostai1/Easter-Spirit2b with vLLM:

Install from pip and serve model

# Install vLLM from pip:
pip install vllm
# Start the vLLM server:
vllm serve "ghostai1/Easter-Spirit2b"
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:8000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "ghostai1/Easter-Spirit2b",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

Use Docker

docker model run hf.co/ghostai1/Easter-Spirit2b:Q4_K_M

Ollama
How to use ghostai1/Easter-Spirit2b with Ollama:
```
ollama run hf.co/ghostai1/Easter-Spirit2b:Q4_K_M
```
Unsloth Desktop

How to use ghostai1/Easter-Spirit2b with Pi:

Start the llama.cpp server

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf ghostai1/Easter-Spirit2b:Q4_K_M

Configure the model in Pi

# Install Pi:
npm install -g @earendil-works/pi-coding-agent
# Add to ~/.pi/agent/models.json:
{
  "providers": {
    "llama-cpp": {
      "baseUrl": "http://localhost:8080/v1",
      "api": "openai-completions",
      "apiKey": "none",
      "models": [
        {
          "id": "ghostai1/Easter-Spirit2b:Q4_K_M"
        }
      ]
    }
  }
}

Run Pi

# Start Pi in your project directory:
pi

Docker Model Runner
How to use ghostai1/Easter-Spirit2b with Docker Model Runner:
```
docker model run hf.co/ghostai1/Easter-Spirit2b:Q4_K_M
```

Lemonade

How to use ghostai1/Easter-Spirit2b with Lemonade:

Pull the model

# Download Lemonade from https://lemonade-server.ai/
lemonade pull ghostai1/Easter-Spirit2b:Q4_K_M

Run and chat with the model

lemonade run user.Easter-Spirit2b-Q4_K_M

List all available models

lemonade list

Hermes Agent

How to use ghostai1/Easter-Spirit2b with Hermes Agent:

Start the llama.cpp server

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf ghostai1/Easter-Spirit2b:Q4_K_M

Configure Hermes

# Install Hermes:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
hermes setup
# Point Hermes at the local server:
hermes config set model.provider custom
hermes config set model.base_url http://127.0.0.1:8080/v1
hermes config set model.default ghostai1/Easter-Spirit2b:Q4_K_M

Run Hermes

hermes

Atomic Chat

OpenClaw

How to use ghostai1/Easter-Spirit2b with OpenClaw:

Start the llama.cpp server

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf ghostai1/Easter-Spirit2b:Q4_K_M

Configure OpenClaw

# Install OpenClaw:
npm install -g openclaw@latest
# Register the local server and set it as the default model:
openclaw onboard --non-interactive --mode local \
  --auth-choice custom-api-key \
  --custom-base-url http://127.0.0.1:8080/v1 \
  --custom-model-id "ghostai1/Easter-Spirit2b:Q4_K_M" \
  --custom-provider-id llama-cpp \
  --custom-compatibility openai \
  --custom-text-input \
  --accept-risk \
  --skip-health

Run OpenClaw

openclaw agent --local --agent main --message "Hello from Hugging Face"

ghostai1 commited on Feb 2

Commit

8c804da

verified ·

1 Parent(s): 9658558

Update README.md

Browse files

Files changed (1) hide show

README.md +51 -40

README.md CHANGED Viewed

@@ -2,70 +2,74 @@
 license: mit
 language:
 - en
 tags:
 - gguf
 - llama.cpp
 - qwen
 - instruct
 - lora
 - roleplay
 - holiday
 - storytelling
-pipeline_tag: text-generation
 ---
-# 🎀 Easter Spirit 2B (GGUF)
-**Easter Spirit 2B** is a lightweight, seasonal language model designed for warm, cheerful, and family-friendly text generation.
-This repository provides **GGUF** builds optimized for **local inference** using the **llama.cpp** ecosystem.
-🔗 **Model page:** https://huggingface.co/ghostai1/Easter-Spirit2b
 ---
 ## Overview
-Easter Spirit 2B focuses on **tone, personality, and atmosphere** rather than deep reasoning or technical precision.
-It is well suited for creative writing, holiday roleplay, and light conversational use on low-resource systems.
----
-## Model Details
-- **Model name:** Easter Spirit 2B
-- **Base model:** Qwen2.5-2B-Instruct
-- **Fine-tuning method:** LoRA (merged)
-- **Parameters:** ~2 billion
-- **Format:** GGUF (llama.cpp compatible)
-- **Language:** English
-- **License:** MIT (base model license applies)
-This model prioritizes:
-- Warm and friendly tone
-- Seasonal and festive expression
-- Wholesome, family-safe outputs
 ---
-## Intended Use
-Recommended for:
-- Creative writing and short stories
-- Easter and spring-themed roleplay
-- Cozy conversational assistants
-- Local demos and experimentation
-- Systems with limited RAM or no GPU
-Not recommended for:
-- Complex reasoning tasks
-- High-accuracy factual retrieval
-- Long-horizon planning or analysis
 ---
 ## Quantized Files
-All files are generated from the same merged model and differ only in quantization level.
 | File | Quantization | Approx. Size |
 |---|---|---:|
@@ -80,18 +84,18 @@ All files are generated from the same merged model and differ only in quantizati
 | `release_v1.Q6_K.gguf` | Q6_K | ~1.27 GB |
 | `release_v1.Q8_0.gguf` | Q8_0 | ~1.65 GB |
-### Recommended Builds
-- **Default (balanced):** `Q4_K_M`
-- **Higher quality:** `Q5_K_M`, `Q6_K`, `Q8_0`
-- **Low-RAM systems:** `Q3_K_M`, `Q2_K`
-- **Ultra-low memory / experimental:** `TQ1_0`
 ---
 ## Usage (llama.cpp)
-### CPU-only example
 ```bash
 ./llama-cli \
@@ -99,3 +103,10 @@ All files are generated from the same merged model and differ only in quantizati
   -ngl 0 \
   -c 4096 \
   -p "Write a cozy springtime story inspired by Easter morning in a small town."

 license: mit
 language:
 - en
+pipeline_tag: text-generation
 tags:
 - gguf
 - llama.cpp
 - qwen
+- qwen2.5
 - instruct
 - lora
 - roleplay
 - holiday
 - storytelling
+- local-inference
+- quantization
+- ggml
+- llm
 ---
+# Easter Spirit 2B (GGUF)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![Format: GGUF](https://img.shields.io/badge/Format-GGUF-orange)](#quantized-files)
+[![Runtime: llama.cpp](https://img.shields.io/badge/Runtime-llama.cpp-purple)](https://github.com/ggerganov/llama.cpp)
+[![Base: Qwen2.5-2B-Instruct](https://img.shields.io/badge/Base-Qwen2.5--2B--Instruct-lightgrey)](#model-details)
+**Easter Spirit 2B** is a compact seasonal model fine-tuned for **warm, cheerful, and family-friendly** text generation.
+This repo contains **GGUF** quantizations for **local inference** with **llama.cpp** and compatible runtimes.
+Model page: https://huggingface.co/ghostai1/Easter-Spirit2b
 ---
 ## Overview
+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.
+Best for:
+- creative writing
+- holiday roleplay
+- light chat assistants
+- offline/local demos on modest hardware
+Not intended for:
+- complex reasoning
+- reliable factual retrieval
+- long-horizon planning
 ---
+## Model Details
+- **Model name:** Easter Spirit 2B
+- **Base model:** Qwen2.5-2B-Instruct
+- **Fine-tuning:** LoRA (merged)
+- **Parameters:** ~2B
+- **Format:** GGUF (llama.cpp compatible)
+- **Language:** English
+- **License:** MIT (base model license applies)
+Behavioral focus:
+- warm, friendly tone
+- spring/Easter seasonal flavor
+- family-safe outputs
 ---
 ## Quantized Files
+All files are produced from the same merged model and differ only by quantization.
 | File | Quantization | Approx. Size |
 |---|---|---:|
 | `release_v1.Q6_K.gguf` | Q6_K | ~1.27 GB |
 | `release_v1.Q8_0.gguf` | Q8_0 | ~1.65 GB |
+### Recommendations
+- **Default (balanced):** `Q4_K_M`
+- **Higher quality:** `Q5_K_M`, `Q6_K`, `Q8_0`
+- **Lower RAM:** `Q3_K_M`, `Q2_K`
+- **Ultra-low memory (experimental):** `TQ1_0`
 ---
 ## Usage (llama.cpp)
+### CPU-only
 ```bash
 ./llama-cli \
   -ngl 0 \
   -c 4096 \
   -p "Write a cozy springtime story inspired by Easter morning in a small town."
+./llama-cli \
+  -m release_v1.Q4_K_M.gguf \
+  -ngl 20 \
+  -c 4096 \
+  -p "Describe a cheerful Easter gathering with a warm, wholesome tone."