Instructions to use Soofi-Project/Soofi-S-Instruct-Preview-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use Soofi-Project/Soofi-S-Instruct-Preview-GGUF with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="Soofi-Project/Soofi-S-Instruct-Preview-GGUF", filename="soofi-s-instruct-preview-Q5_K_M.gguf", )
llm.create_chat_completion( messages = [ { "role": "user", "content": "What is the capital of France?" } ] ) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use Soofi-Project/Soofi-S-Instruct-Preview-GGUF 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 Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_M # Run inference directly in the terminal: llama cli -hf Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_M # Run inference directly in the terminal: llama cli -hf Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_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 Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_M # Run inference directly in the terminal: ./llama-cli -hf Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_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 Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_M
Use Docker
docker model run hf.co/Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_M
- LM Studio
- Jan
- vLLM
How to use Soofi-Project/Soofi-S-Instruct-Preview-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "Soofi-Project/Soofi-S-Instruct-Preview-GGUF" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Soofi-Project/Soofi-S-Instruct-Preview-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_M
- Ollama
How to use Soofi-Project/Soofi-S-Instruct-Preview-GGUF with Ollama:
ollama run hf.co/Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_M
- Unsloth Studio
How to use Soofi-Project/Soofi-S-Instruct-Preview-GGUF with Unsloth Studio:
Install Unsloth Studio (macOS, Linux, WSL)
curl -fsSL https://unsloth.ai/install.sh | sh # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for Soofi-Project/Soofi-S-Instruct-Preview-GGUF to start chatting
Install Unsloth Studio (Windows)
irm https://unsloth.ai/install.ps1 | iex # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for Soofi-Project/Soofi-S-Instruct-Preview-GGUF to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for Soofi-Project/Soofi-S-Instruct-Preview-GGUF to start chatting
- Pi
How to use Soofi-Project/Soofi-S-Instruct-Preview-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_M
Configure the model in Pi
# Install Pi: npm install -g @mariozechner/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use Soofi-Project/Soofi-S-Instruct-Preview-GGUF with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_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 Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_M
Run Hermes
hermes
- Atomic Chat new
- OpenClaw new
How to use Soofi-Project/Soofi-S-Instruct-Preview-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_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 "Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_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"
- Docker Model Runner
How to use Soofi-Project/Soofi-S-Instruct-Preview-GGUF with Docker Model Runner:
docker model run hf.co/Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_M
- Lemonade
How to use Soofi-Project/Soofi-S-Instruct-Preview-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_M
Run and chat with the model
lemonade run user.Soofi-S-Instruct-Preview-GGUF-Q5_K_M
List all available models
lemonade list
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh
# Start a local OpenAI-compatible server with a web UI:
llama serve -hf Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_M# Run inference directly in the terminal:
llama cli -hf Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_MInstall from WinGet (Windows)
winget install llama.cpp
# Start a local OpenAI-compatible server with a web UI:
llama serve -hf Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_M# Run inference directly in the terminal:
llama cli -hf Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_MUse 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 Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_M# Run inference directly in the terminal:
./llama-cli -hf Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_MBuild 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 Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_M# Run inference directly in the terminal:
./build/bin/llama-cli -hf Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_MUse Docker
docker model run hf.co/Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_MSoofi-S-Instruct-Preview-GGUF
⚠️ Preview / internal checkpoint. Weights and metadata may still change.
GGUF quantizations of Soofi-Project/Soofi-S-Instruct-Preview for use with llama.cpp and Ollama.
Converted from fp16 safetensors with convert_hf_to_gguf.py and quantized with
llama-quantize (llama.cpp).
Architecture support: SOOFI-S is a custom hybrid Mamba-2/MoE model and ships with its own modeling code. GGUF conversion requires a build of llama.cpp that understands this architecture — verify against the actual checkpoint before relying on these quants.
Available quantizations
| File | Quant | Bits/weight | Size (approx.) | Recommendation |
|---|---|---|---|---|
soofi-s-instruct-preview-Q8_0.gguf |
Q8_0 | 8.5 | ~32 GB | Practically lossless, maximum quality |
soofi-s-instruct-preview-Q5_K_M.gguf |
Q5_K_M | 6.6 | ~25 GB | Good size/quality trade-off, recommended default |
soofi-s-instruct-preview-Q4_K_M.gguf |
Q4_K_M | ~5.5 | ~21 GB | Smallest, for tighter memory budgets |
Sizes scale with the total 30B parameters (not the 3.5B active). Q4_K_M is an estimate; the others are measured.
No Q6_K: this architecture's tensor columns (2688/1856/3712) are not divisible by 256, so every K-quant tensor falls back to a non-K type. For Q6_K that fallback is q8_0, making it ~as large as Q8_0 for no gain; Q5_K_M and Q4_K_M fall back to q5_1/q4_1 and still shrink.
Usage with Ollama
Directly from this repo (select the quant level via the tag):
ollama run hf.co/Soofi-Project/Soofi-S-Instruct-Preview-GGUF:Q5_K_M
For a private repo, Ollama needs to know your HF token; otherwise use the local Modelfile route.
Locally with a Modelfile:
Ollama uses Go templates and does not apply the Jinja chat_template
embedded in the GGUF, so supply a matching Go template yourself; otherwise
Ollama falls back to a generic one that may miss this model's ChatML format and
its non-thinking behaviour. Unlike the Isar/Rhine reasoning variants, the
Instruct chat template carries no identity in its default system prompt
(only a date) and is non-thinking by default, so the template below closes
the <think> block immediately:
FROM ./soofi-s-instruct-preview-Q5_K_M.gguf
PARAMETER temperature 0.6
PARAMETER top_p 0.95
PARAMETER num_ctx 8192
PARAMETER stop "<|im_end|>"
TEMPLATE """{{- if .System }}<|im_start|>system
{{ .System }}<|im_end|>
{{ end }}
{{- range .Messages }}
{{- if eq .Role "user" }}<|im_start|>user
{{ .Content }}<|im_end|>
{{ else if eq .Role "assistant" }}<|im_start|>assistant
{{ .Content }}<|im_end|>
{{ end }}
{{- end }}<|im_start|>assistant
<think></think>"""
ollama create soofi-s-instruct:q5 -f Modelfile
ollama run soofi-s-instruct:q5
Thinking is disabled at the template level. The prompt ends with a closed
<think></think>, so the model answers directly instead of emitting a reasoning block — you do not need to turn thinking off in your client (e.g. Open WebUI). Without this (a generic template, or thehf.coroute that leaves<think>open), the whole answer ends up inside the think block.No identity system prompt here. The Instruct chat template's default system prompt contains only a knowledge cutoff and date — no "You are Soofi …" text. If this variant still identifies as Soofi in vLLM, that identity is baked into the weights (and therefore survives quantization), not injected by the template. To force a fixed identity, add a
SYSTEM """…"""block (see the Isar/Rhine GGUF cards for the wording).Tool calling is intentionally omitted from this Go template. The model's native tool format (
<tool_call><function=…>) is not reproduced here, so Ollama's native function-calling path is unavailable. In Open WebUI, MCP tools still work via the prompt-based Default function-calling mode (Open WebUI handles tool calls in its own layer). For robust native tool calling with the original format, run the model underllama-server --jinjainstead, which applies the GGUF's embedded Jinja template (identity and tools) verbatim — see the llama.cpp section below.
Usage with llama.cpp
llama-cli -m soofi-s-instruct-preview-Q5_K_M.gguf -p "Explain AI sovereignty in one sentence."
# or as an OpenAI-compatible server:
llama-server -m soofi-s-instruct-preview-Q5_K_M.gguf --jinja --port 8080
Use
--jinja. It makes llama.cpp apply the GGUF's embedded chat template (the model's own Jinja), so the native tool-calling format works out of the box — no manual template needed. This is the recommended backend for native function calling (e.g. as an OpenAI endpoint in Open WebUI).
Architecture note
This is a hybrid Mixture-of-Experts model designed from scratch: 23 Mamba-2/MoE layers + 6 attention layers, 128 routing experts + 1 shared expert per MoE layer, 6 experts active per token (30B total / 3.5B active). During quantization, router/gate and certain attention tensors may intentionally be kept at higher precision; the same applies to the SSM/recurrent (Mamba-2) tensors. A recent version of llama.cpp is recommended.
Related models
- Base (bf16): Soofi-Project/Soofi-S-Instruct-Preview
- FP8 quantization (vLLM): Soofi-Project/Soofi-S-Instruct-Preview-FP8
License & provenance
Released under a custom license ("Other"), following the base model Soofi-Project/Soofi-S-Instruct-Preview. TODO: mirror the full license text once the base model card defines it.
- Downloads last month
- 33
Model tree for Soofi-Project/Soofi-S-Instruct-Preview-GGUF
Base model
Soofi-Project/Soofi-S-Instruct-Preview
# Gated model: Login with a HF token with gated access permission hf auth login