Instructions to use mad-lab-ai/smollm3-npc with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use mad-lab-ai/smollm3-npc with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="mad-lab-ai/smollm3-npc", filename="smollm3-npc-q8_0.gguf", )
llm.create_chat_completion( messages = "No input example has been defined for this model task." )
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use mad-lab-ai/smollm3-npc 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 mad-lab-ai/smollm3-npc:Q8_0 # Run inference directly in the terminal: llama cli -hf mad-lab-ai/smollm3-npc:Q8_0
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf mad-lab-ai/smollm3-npc:Q8_0 # Run inference directly in the terminal: llama cli -hf mad-lab-ai/smollm3-npc:Q8_0
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 mad-lab-ai/smollm3-npc:Q8_0 # Run inference directly in the terminal: ./llama-cli -hf mad-lab-ai/smollm3-npc:Q8_0
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 mad-lab-ai/smollm3-npc:Q8_0 # Run inference directly in the terminal: ./build/bin/llama-cli -hf mad-lab-ai/smollm3-npc:Q8_0
Use Docker
docker model run hf.co/mad-lab-ai/smollm3-npc:Q8_0
- LM Studio
- Jan
- Ollama
How to use mad-lab-ai/smollm3-npc with Ollama:
ollama run hf.co/mad-lab-ai/smollm3-npc:Q8_0
- Unsloth Studio
How to use mad-lab-ai/smollm3-npc 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 mad-lab-ai/smollm3-npc 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 mad-lab-ai/smollm3-npc to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for mad-lab-ai/smollm3-npc to start chatting
- Atomic Chat new
- Docker Model Runner
How to use mad-lab-ai/smollm3-npc with Docker Model Runner:
docker model run hf.co/mad-lab-ai/smollm3-npc:Q8_0
- Lemonade
How to use mad-lab-ai/smollm3-npc with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull mad-lab-ai/smollm3-npc:Q8_0
Run and chat with the model
lemonade run user.smollm3-npc-Q8_0
List all available models
lemonade list
llm.create_chat_completion(
messages = "No input example has been defined for this model task."
)mad-lab-npc-smollm3-3b
A LoRA fine-tune of SmolLM3-3B for D&D NPC roleplay, trained on character dialogue drawing from Forgotten Realms, Lord of the Rings, and The Witcher lore, settings, and characters.
Intended Use
Interactive NPC roleplay in tabletop RPG contexts. The model responds in-character to player actions as directed by a Dungeon Master.
Required Prompt Format
The model requires a specific input format to trigger roleplay behavior:
System prompt:
You are an NPC actor in an ongoing D&D campaign. You embody characters as directed by the Dungeon Master. Always structure your response using this format: Physical action or reaction in italics. "Spoken dialogue in quotes."
User turn: [CHARACTER: ] [SCENE: ] [MOOD: ] [PLAYER ACTION: ]
Expected output format: Grabs the edge of the bar and leans forward slowly. "You'd best be careful who you ask that question, stranger."
Training Details
- Base model: HuggingFaceTB/SmolLM3-3B
- Fine-tune method: LoRA / QLoRA
- Dataset: Synthetically generated D&D NPC dialogue with lore grounding from Forgotten Realms, LOTR, and Witcher universes, mixed with PygmalionAI/PIPPA and Norquinal/claude_multiround_chat_30k
- Output format: ShareGPT / ChatML
- Downloads last month
- -
8-bit
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="mad-lab-ai/smollm3-npc", filename="smollm3-npc-q8_0.gguf", )