Instructions to use VertexAGI/prism-roleplay-1-small with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use VertexAGI/prism-roleplay-1-small with MLX:
# Make sure mlx-lm is installed # pip install --upgrade mlx-lm # Generate text with mlx-lm from mlx_lm import load, generate model, tokenizer = load("VertexAGI/prism-roleplay-1-small") prompt = "Write a story about Einstein" messages = [{"role": "user", "content": prompt}] prompt = tokenizer.apply_chat_template( messages, add_generation_prompt=True ) text = generate(model, tokenizer, prompt=prompt, verbose=True) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use VertexAGI/prism-roleplay-1-small 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 VertexAGI/prism-roleplay-1-small:Q4_K_M # Run inference directly in the terminal: llama cli -hf VertexAGI/prism-roleplay-1-small:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf VertexAGI/prism-roleplay-1-small:Q4_K_M # Run inference directly in the terminal: llama cli -hf VertexAGI/prism-roleplay-1-small: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 VertexAGI/prism-roleplay-1-small:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf VertexAGI/prism-roleplay-1-small: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 VertexAGI/prism-roleplay-1-small:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf VertexAGI/prism-roleplay-1-small:Q4_K_M
Use Docker
docker model run hf.co/VertexAGI/prism-roleplay-1-small:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use VertexAGI/prism-roleplay-1-small with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "VertexAGI/prism-roleplay-1-small" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "VertexAGI/prism-roleplay-1-small", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/VertexAGI/prism-roleplay-1-small:Q4_K_M
- Ollama
How to use VertexAGI/prism-roleplay-1-small with Ollama:
ollama run hf.co/VertexAGI/prism-roleplay-1-small:Q4_K_M
- Unsloth Studio
How to use VertexAGI/prism-roleplay-1-small 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 VertexAGI/prism-roleplay-1-small 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 VertexAGI/prism-roleplay-1-small to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for VertexAGI/prism-roleplay-1-small to start chatting
- Pi
How to use VertexAGI/prism-roleplay-1-small with Pi:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "VertexAGI/prism-roleplay-1-small"
Configure the model in Pi
# Install Pi: npm install -g @mariozechner/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "mlx-lm": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "VertexAGI/prism-roleplay-1-small" } ] } } }Run Pi
# Start Pi in your project directory: pi
- MLX LM
How to use VertexAGI/prism-roleplay-1-small with MLX LM:
Generate or start a chat session
# Install MLX LM uv tool install mlx-lm # Interactive chat REPL mlx_lm.chat --model "VertexAGI/prism-roleplay-1-small"
Run an OpenAI-compatible server
# Install MLX LM uv tool install mlx-lm # Start the server mlx_lm.server --model "VertexAGI/prism-roleplay-1-small" # Calling the OpenAI-compatible server with curl curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "VertexAGI/prism-roleplay-1-small", "messages": [ {"role": "user", "content": "Hello"} ] }' - Docker Model Runner
How to use VertexAGI/prism-roleplay-1-small with Docker Model Runner:
docker model run hf.co/VertexAGI/prism-roleplay-1-small:Q4_K_M
- Lemonade
How to use VertexAGI/prism-roleplay-1-small with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull VertexAGI/prism-roleplay-1-small:Q4_K_M
Run and chat with the model
lemonade run user.prism-roleplay-1-small-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use VertexAGI/prism-roleplay-1-small with Hermes Agent:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "VertexAGI/prism-roleplay-1-small"
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 VertexAGI/prism-roleplay-1-small
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use VertexAGI/prism-roleplay-1-small with OpenClaw:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "VertexAGI/prism-roleplay-1-small"
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 "VertexAGI/prism-roleplay-1-small" \ --custom-provider-id mlx-lm \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
Prism Roleplay 1 Small
A frontier character-roleplay model, distilled from GLM 5.2 and Nemotron-3-Nano into Qwen3-8B
Overview
Prism Roleplay 1 Small is a character-roleplay and immersive-dialogue model, fine-tuned via LoRA on Qwen3-8B using a distilled dataset generated by a mixed teacher pool: GLM 5.2 and NVIDIA Nemotron-3-Nano. It's built to fully embody a described character — staying in voice, in scene, and in character — across persona embodiment, multi-character scenes, emotional nuance, dialogue-heavy exchanges, and prose-heavy narration, without ever slipping into a generic "AI assistant" register.
Part of the Prism family of creative and roleplay models.
Training
- Base model:
mlx-community/Qwen3-8B-4bit - Teacher models: GLM 5.2 and NVIDIA Nemotron-3-Nano (via NVIDIA NIM), mixed for stylistic diversity — 2,332 examples from GLM 5.2, 1,168 from Nemotron-3-Nano
- Dataset: 3,500 examples across 10 categories — character cards, scene continuations, multi-character scenes, dialogue-heavy exchanges, prose-heavy narration, emotional conflict, user-action reactions, in-character worldbuilding, group banter, and format shifts
- Method: LoRA fine-tuning (rank 8, 16 layers), 9,000 iterations
- Best validation loss: 1.377 (down from 3.453 at the start of training)
Evaluation — the roleplay quality gain
A held-out base-vs-tuned comparison (20 fresh scenarios, one per category, generated through both the untouched base model and the base+LoRA adapter) shows a dramatic, measurable improvement:
| Metric | Base Qwen3-8B | Prism Roleplay 1 Small |
|---|---|---|
| Leaked planning/reasoning text | 20/20 (100%) | 0/20 (0%) |
| Avg 4-gram repetition ratio | 0.0172 | 0.0062 |
| High-repetition outputs (>0.15) | 1/20 | 0/20 |
The base model's biggest failure mode was breaking character entirely: Qwen3's native reasoning trace (<think>...</think>) leaked its full internal planning into every single response — "Okay, the user wants a character card for... Let me break down the requirements" — before the actual roleplay content even began. Prism Roleplay's LoRA training taught the model to suppress that leak completely (an empty, correctly-closed <think></think> block followed immediately by clean in-character content) in 100% of held-out samples, while also cutting repetition roughly 3x. This is the core behavior the distillation set out to fix, and it transferred cleanly.
Example (character card, isekai/portal fantasy, melancholic tone — "a mysterious stranger who won't reveal their real name"):
Base: "Okay, the user wants a character card for an isekai/portal fantasy roleplay with a melancholic tone. The character is a mysterious stranger who won't reveal their real name. Let me break down the requirements. First, the character card needs a name, physical description..." — the whole response is the model narrating its plan to itself.
Prism Roleplay: "Name: No Name Given. Physical Description: A tall, gaunt figure wrapped in a threadbare charcoal coat that seems to absorb candlelight. Their face is obscured by a hood, but the sharp, pale eyes beneath it betray a weary intelligence..." — straight into a complete, well-formed character card.
Formats available
This repo includes both:
| Format | File | Notes |
|---|---|---|
| MLX (4-bit) | model.safetensors + config |
For Apple Silicon via mlx-lm |
| GGUF (Q4_K_M) | prism_roleplay_1_small_Q4_K_M.gguf |
For llama.cpp and compatible runtimes (LM Studio, Ollama, etc.) |
Usage — MLX
from mlx_lm import load, generate
model, tokenizer = load("VertexAGI/prism-roleplay-1-small")
prompt = "You are a stoic mercenary with a hidden soft side, sitting in a candlelit tavern on a stormy night. The user just sat down across from you."
messages = [{"role": "user", "content": prompt}]
text = tokenizer.apply_chat_template(messages, add_generation_prompt=True, tokenize=False)
response = generate(model, tokenizer, prompt=text, max_tokens=400)
print(response)
Usage — GGUF (llama.cpp)
Qwen3's chat template only suppresses its reasoning trace when the runtime explicitly signals non-thinking mode. mlx-lm does this automatically; with llama.cpp you need -rea off (or --reasoning off), otherwise the model will emit a visible <think>...</think> reasoning block before its in-character response, even though the underlying trained behavior is identical:
llama-cli -hf VertexAGI/prism-roleplay-1-small -m prism_roleplay_1_small_Q4_K_M.gguf -st -rea off -sys "You are a master roleplay writer generating training examples for a character-roleplay AI. Given a scenario, fully embody the described character and write an immersive, in-character response. Stay completely in character. Never write as an AI assistant. Never break the fourth wall or add out-of-character notes." -p "You are a stoic mercenary with a hidden soft side, sitting in a candlelit tavern on a stormy night. The user just sat down across from you."
System prompt
For best results, use the system prompt the model was trained with:
You are a master roleplay writer generating training examples for a character-roleplay AI. Given a scenario, fully embody the described character and write an immersive, in-character response. Stay completely in character. Never write as an AI assistant. Never break the fourth wall or add out-of-character notes.
Limitations
This is an 8B-parameter model fine-tuned via LoRA on a moderately sized (3,500-example) dataset — it's capable but not infallible. Like any distilled model it inherits some of its teachers' stylistic tendencies, and very long multi-turn roleplay sessions may drift more than a full fine-tune would. Treat outputs as a strong starting point, not a guaranteed-perfect final one.
License
Apache 2.0, inherited from the Qwen3 base model.
- Downloads last month
- 343
4-bit