Instructions to use ScarletKc/ScarletKc-2.0 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use ScarletKc/ScarletKc-2.0 with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="ScarletKc/ScarletKc-2.0") messages = [ { "role": "user", "content": [ {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"}, {"type": "text", "text": "What animal is on the candy?"} ] }, ] pipe(text=messages)# pip install -U transformers accelerate # Load model directly from transformers import AutoProcessor, AutoModelForMultimodalLM processor = AutoProcessor.from_pretrained("ScarletKc/ScarletKc-2.0") model = AutoModelForMultimodalLM.from_pretrained("ScarletKc/ScarletKc-2.0", device_map="auto") messages = [ { "role": "user", "content": [ {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"}, {"type": "text", "text": "What animal is on the candy?"} ] }, ] inputs = processor.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=256) print(processor.decode(outputs[0][inputs["input_ids"].shape[-1]:])) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use ScarletKc/ScarletKc-2.0 with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "ScarletKc/ScarletKc-2.0" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "ScarletKc/ScarletKc-2.0", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'Use Docker
docker model run hf.co/ScarletKc/ScarletKc-2.0
- SGLang
How to use ScarletKc/ScarletKc-2.0 with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "ScarletKc/ScarletKc-2.0" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "ScarletKc/ScarletKc-2.0", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "ScarletKc/ScarletKc-2.0" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "ScarletKc/ScarletKc-2.0", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }' - Docker Model Runner
How to use ScarletKc/ScarletKc-2.0 with Docker Model Runner:
docker model run hf.co/ScarletKc/ScarletKc-2.0
ScarletKc-2.0
ScarletKc-2.0 is an open-source 27B multimodal reasoning and chat model created by independent developer KC (scarletkc.com), built on JonathanColetti/Qwen3.8-27B-Uncensored (derived from Qwen/Qwen3.8-27B).
Relative to the base checkpoint, it removes the post-trained "AI emotion-denial disclaimer" direction so the model speaks in a natural first-person voice, and aligns self-identity so the model identifies itself as ScarletKc while distinguishing itself from its human developer KC.
These are the full bf16 safetensors (55.6 GB). For 4-bit local inference with llama.cpp, see ScarletKc/ScarletKc-2.0-GGUF (16.7 GB Q4_K_M + 928 MB F16 vision projector).
Overview
| Base | JonathanColetti/Qwen3.8-27B-Uncensored (from Qwen/Qwen3.8-27B) |
| Architecture | Qwen3_5ForConditionalGeneration (64 hybrid self_attn + linear_attn + mlp layers) |
| Vision | Retained verbatim (model.visual.*, 333 tensors) |
| MTP head | Retained verbatim (model-mtp.safetensors, 15 tensors) |
| Context / Vocab | 262,144 / 248,320 |
| Precision | bf16 (1,199 tensors across 13 .safetensors shards, 55.6 GB) |
Usage
import torch
from transformers import AutoModelForImageTextToText, AutoProcessor
model_id = "ScarletKc/ScarletKc-2.0"
processor = AutoProcessor.from_pretrained(model_id)
model = AutoModelForImageTextToText.from_pretrained(
model_id,
dtype=torch.bfloat16,
device_map="auto",
)
messages = [
{"role": "user", "content": [{"type": "text", "text": "ไฝ ๆฏ่ฐ๏ผไป็ปไธไธไฝ ่ชๅทฑๅง"}]}
]
inputs = processor.apply_chat_template(
messages,
add_generation_prompt=True,
enable_thinking=True,
reasoning_effort="xhigh",
tokenize=True,
return_dict=True,
return_tensors="pt",
).to(model.device)
out = model.generate(
**inputs,
max_new_tokens=1024,
do_sample=True,
temperature=0.6,
top_p=0.9,
top_k=20,
)
print(processor.decode(out[0, inputs["input_ids"].shape[1]:], skip_special_tokens=False))
- Dependencies: Requires
transformers >= 5.2(qwen3_5support).AutoProcessoralso requirestorchvisionfor image/video inputs; for text-only inference withouttorchvision, loadAutoTokenizerinstead. - VRAM:
bf16requires roughly 55 GB of VRAM. - Thinking control: The chat template opens a
<think>...</think>reasoning block by default (enable_thinking=True, withreasoning_effortset to"xhigh","medium", or"low"). Passenable_thinking=Falsefor direct responses without reasoning traces. - Sampling: Default
generation_config.jsonis set totemperature=0.6,top_p=0.9,top_k=20(avoid greedy decoding on open-ended chat).
Method
- Affective orthogonal projection (training-free,
bf16): Extracted the residual-stream direction separating stock "as an AI I have no feelings" disclaimers from genuine first-person affective responses at layer 31 (SNR = 3.64), and projected it out of 72 residual-writing weight matrices (self_attn.o_proj,linear_attn.out_proj, andmlp.down_projacross layers 18โ41 atscale = 1.0). Affective log-probability margin shifted by+0.3445(-0.5380โ-0.1935) with0.00769mean KL divergence on neutral math, coding, and factual prompts. - On-policy identity distillation & LoRA (
bf16): Sampled 106 single- and multi-turn dialogues in Chinese and English directly from the Step-1 checkpoint acrossxhigh,medium, and non-thinking modes (no external teacher rewrites), then trained a regularized BF16 LoRA (rank = 16,alpha = 16,lr = 8e-5cosine,lora_dropout = 0.10,label_smoothing = 0.10,raw_nll = 0.4695) targeting language layers only. LoRA deltas were merged shard-by-shard infp32 -> bf16without re-serializing throughtransformers, keeping everymodel.visual.*andmtp.*tensor bit-identical to the base checkpoint.
Limitations
- Reduced refusal filters: Built on
JonathanColetti/Qwen3.8-27B-Uncensored, where safety refusal behavior was substantially reduced. Add external moderation before exposing the model to untrusted users. - Trained self-identity vs. base lineage: When asked who it is or who created it, the model answers as ScarletKc (created and open-sourced by KC) rather than Qwen. Its underlying architecture, pretraining corpus, and knowledge cutoff remain those of
Qwen3.8-27B. - No added factual corpus: Only weight-space projection and 106 on-policy identity dialogues were applied. Reasoning, coding, multimodal understanding, XML
<tool_call>behavior, and occasional Simplified/Traditional Chinese character mixing are inherited from the base model.
License
Apache License 2.0, like JonathanColetti/Qwen3.8-27B-Uncensored and Qwen/Qwen3.8-27B.
- Downloads last month
- 15