HuggingFace · 3B · كثيف

استدلال خفيف متعدّد اللغات. تعرّف على ما إذا كان كرت شاشتك أو جهاز الماك قادرًا على تشغيل SmolLM3 3B محليًا — 1.7 جيجابايت كحد أدنى، و2.8 جيجابايت موصى بها.

كيف تستخدم SmolLM3 3B في Transformers

حمّل SmolLM3 3B في بايثون عبر مكتبة Transformers من HuggingFace. هذه الأوزان الكاملة غير المكمَّمة، فتحتاج ذاكرة أكبر من ملفات GGUF.

عبر pipeline — الطريقة الأسهل

pip install -U transformers
# Use a pipeline as a high-level helper
from transformers import pipeline

pipe = pipeline("text-generation", model="HuggingFaceTB/SmolLM3-3B")
messages = [
    {"role": "user", "content": "Who are you?"},
]
pipe(messages)

تحميل النموذج مباشرة

pip install -U transformers
# Load model directly
from transformers import AutoTokenizer, AutoModelForCausalLM

tokenizer = AutoTokenizer.from_pretrained("HuggingFaceTB/SmolLM3-3B")
model = AutoModelForCausalLM.from_pretrained("HuggingFaceTB/SmolLM3-3B", device_map="auto")
messages = [
    {"role": "user", "content": "Who are you?"},
]
inputs = tokenizer.apply_chat_template(
	messages,
	add_generation_prompt=True,
	tokenize=True,
	return_dict=True,
	return_tensors="pt",
).to(model.device)

outputs = model.generate(**inputs, max_new_tokens=40)
print(tokenizer.decode(outputs[0][inputs["input_ids"].shape[-1]:]))

التوثيق الرسمي: Transformers

كيف تستخدم SmolLM3 3B في llama.cpp

يحمّل llama.cpp ملف SmolLM3 3B من HuggingFace مباشرة ويشغّله، إمّا خادمًا متوافقًا مع OpenAI بواجهة ويب أو في الطرفية. اختر مستوى الـ Quantization من القائمة، وتتحدّث الأوامر معه.

ملف GGUF من unsloth/SmolLM3-3B-GGUF

التثبيت على macOS وLinux

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

التثبيت عبر WinGet على Windows

winget install llama.cpp
# Start a local OpenAI-compatible server with a web UI:
llama serve -hf unsloth/SmolLM3-3B-GGUF:Q4_K_M
# Run inference directly in the terminal:
llama cli -hf unsloth/SmolLM3-3B-GGUF:Q4_K_M

نسخة جاهزة من صفحة الإصدارات

# 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 unsloth/SmolLM3-3B-GGUF:Q4_K_M
# Run inference directly in the terminal:
./llama-cli -hf unsloth/SmolLM3-3B-GGUF:Q4_K_M

البناء من الكود المصدري

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 unsloth/SmolLM3-3B-GGUF:Q4_K_M
# Run inference directly in the terminal:
./build/bin/llama-cli -hf unsloth/SmolLM3-3B-GGUF:Q4_K_M

عبر Docker

docker model run hf.co/unsloth/SmolLM3-3B-GGUF:Q4_K_M

التوثيق الرسمي: llama.cpp

كيف تستخدم SmolLM3 3B في Ollama

ينزّل Ollama النموذج ويفتح محادثة محلية بأمر واحد. اختر مستوى الـ Quantization من القائمة، وتتحدّث الأوامر معه.

ملف GGUF من unsloth/SmolLM3-3B-GGUF

من ملف GGUF على HuggingFace

ollama run hf.co/unsloth/SmolLM3-3B-GGUF:Q4_K_M

التوثيق الرسمي: Ollama

كيف تستخدم SmolLM3 3B في Pi

Pi وكيل برمجة يعمل في الطرفية. شغّل SmolLM3 3B على خادم llama.cpp محلي ثم وجّه Pi إليه. اختر مستوى الـ Quantization من القائمة، وتتحدّث الأوامر معه.

ملف GGUF من unsloth/SmolLM3-3B-GGUF

شغّل خادم llama.cpp

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf unsloth/SmolLM3-3B-GGUF:Q4_K_M

أضف النموذج إلى 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": "unsloth/SmolLM3-3B-GGUF:Q4_K_M"
        }
      ]
    }
  }
}

شغّل Pi

# Start Pi in your project directory:
pi

التوثيق الرسمي: Pi

كيف تستخدم SmolLM3 3B في node-llama-cpp

شغّل SmolLM3 3B من Node.js بلا تثبيت مسبق. اختر مستوى الـ Quantization من القائمة، وتتحدّث الأوامر معه.

ملف GGUF من unsloth/SmolLM3-3B-GGUF

محادثة مع النموذج

npx -y node-llama-cpp chat hf:unsloth/SmolLM3-3B-GGUF:Q4_K_M

قدّر توافق النموذج مع جهازك

npx -y node-llama-cpp inspect estimate hf:unsloth/SmolLM3-3B-GGUF:Q4_K_M

التوثيق الرسمي: node-llama-cpp

كيف تستخدم SmolLM3 3B في Docker Model Runner

يشغّل Docker Desktop النموذج محليًا ويتيحه عبر واجهة متوافقة مع OpenAI. اختر مستوى الـ Quantization من القائمة، وتتحدّث الأوامر معه.

ملف GGUF من unsloth/SmolLM3-3B-GGUF

شغّل النموذج

docker model run hf.co/unsloth/SmolLM3-3B-GGUF:Q4_K_M

التوثيق الرسمي: Docker Model Runner

كيف تستخدم SmolLM3 3B في LocalAI

LocalAI خادم محلي متوافق مع OpenAI. استبدل {{GGUF_FILE}} باسم ملف GGUF الذي تريده من المستودع unsloth/SmolLM3-3B-GGUF.

التثبيت من ملف تنفيذي

curl https://localai.io/install.sh | sh
# Load and run the model:
local-ai run huggingface://unsloth/SmolLM3-3B-GGUF/{{GGUF_FILE}}

عبر صور Docker

# Pull the image:
docker pull localai/localai:latest-cpu
# Load and run the model:
docker run -p 8080:8080 --name localai -v $PWD/models:/build/models localai/localai:latest-cpu huggingface://unsloth/SmolLM3-3B-GGUF/{{GGUF_FILE}}

التوثيق الرسمي: LocalAI

كيف تستخدم SmolLM3 3B في Lemonade

Lemonade خادم محلي من AMD يعمل على المعالجات وكروت الشاشة. اختر مستوى الـ Quantization من القائمة، وتتحدّث الأوامر معه.

ملف GGUF من unsloth/SmolLM3-3B-GGUF

نزّل النموذج

# Download Lemonade from https://lemonade-server.ai/
lemonade pull unsloth/SmolLM3-3B-GGUF:Q4_K_M

شغّل النموذج وحاوره

lemonade run user.SmolLM3-3B-GGUF-Q4_K_M

اعرض كل النماذج المتاحة

lemonade list

التوثيق الرسمي: Lemonade

كيف تستخدم SmolLM3 3B في Hermes Agent

وكيل Hermes من Nous Research. شغّل SmolLM3 3B على خادم llama.cpp محلي ثم وجّه Hermes إليه. اختر مستوى الـ Quantization من القائمة، وتتحدّث الأوامر معه.

ملف GGUF من unsloth/SmolLM3-3B-GGUF

شغّل خادم llama.cpp

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf unsloth/SmolLM3-3B-GGUF:Q4_K_M

اضبط 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 unsloth/SmolLM3-3B-GGUF:Q4_K_M

شغّل Hermes

hermes

التوثيق الرسمي: Hermes Agent

كيف تستخدم SmolLM3 3B في OpenClaw

OpenClaw وكيل مفتوح المصدر يعمل على جهازك. شغّل SmolLM3 3B على خادم llama.cpp محلي ثم سجّله في OpenClaw. اختر مستوى الـ Quantization من القائمة، وتتحدّث الأوامر معه.

ملف GGUF من unsloth/SmolLM3-3B-GGUF

شغّل خادم llama.cpp

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf unsloth/SmolLM3-3B-GGUF:Q4_K_M

اضبط 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 "unsloth/SmolLM3-3B-GGUF:Q4_K_M" \
  --custom-provider-id llama-cpp \
  --custom-compatibility openai \
  --custom-text-input \
  --accept-risk \
  --skip-health

شغّل OpenClaw

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

التوثيق الرسمي: OpenClaw

أوامر التشغيلHuggingFace
2025-07سياق 128K

مستويات الـ Quantization

Quantizationالبتاتالذاكرةالجودةالحالة
Q2_K21.5GBمنخفضة—
Q3_K_M31.8GBمتوسطة—
Q4_K_M42GBجيدة—
Q5_K_M52.4GBجيدة—
Q6_K62.8GBممتازة—
Q8_083.6GBممتازة—
F16166.6GBبلا فقد—

الأرقام تشمل الأوزان وذاكرة KV عند طول سياق 2K توكن. غيّر طول السياق من لوحة جهازك لترى أثره على الذاكرة والسرعة.

أسئلة شائعة عن تشغيل SmolLM3 3B محليًا

هل أستطيع تشغيل SmolLM3 3B على جهازي؟
يحتاج SmolLM3 3B إلى 1.7 جيجابايت من الذاكرة كحد أدنى، والموصى به 2.8 جيجابايت. يكفي أن تفتح هذه الصفحة ليُقيَّم النموذج تلقائيًا أمام كرت شاشتك أو جهاز الماك، ثم تشغّله عبر Ollama أو LM Studio أو llama.cpp.
كم يحتاج SmolLM3 3B من الـ VRAM؟
بتكميم Q4_K_M يستهلك SmolLM3 3B نحو 2 جيجابايت من ذاكرة الكرت. أما المستويات الأعلى فتحتاج ذاكرة أكبر، والأدنى تناسب الكروت المحدودة مقابل تنازل في الجودة.