Instructions to use PinkPixel/CrystalThink-2B with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use PinkPixel/CrystalThink-2B with Transformers:

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

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

# Load model directly
from transformers import AutoTokenizer, AutoModelForCausalLM

tokenizer = AutoTokenizer.from_pretrained("PinkPixel/CrystalThink-2B")
model = AutoModelForCausalLM.from_pretrained("PinkPixel/CrystalThink-2B")
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]:]))

Notebooks
Google Colab
Kaggle
Local Apps

vLLM

How to use PinkPixel/CrystalThink-2B with vLLM:

Install from pip and serve model

# Install vLLM from pip:
pip install vllm
# Start the vLLM server:
vllm serve "PinkPixel/CrystalThink-2B"
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:8000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "PinkPixel/CrystalThink-2B",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

Use Docker

docker model run hf.co/PinkPixel/CrystalThink-2B

SGLang

How to use PinkPixel/CrystalThink-2B 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 "PinkPixel/CrystalThink-2B" \
    --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": "PinkPixel/CrystalThink-2B",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

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 "PinkPixel/CrystalThink-2B" \
        --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": "PinkPixel/CrystalThink-2B",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

Unsloth Studio new

How to use PinkPixel/CrystalThink-2B 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 PinkPixel/CrystalThink-2B 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 PinkPixel/CrystalThink-2B to start chatting

Using HuggingFace Spaces for Unsloth

# No setup required
# Open https://huggingface.co/spaces/unsloth/studio in your browser
# Search for PinkPixel/CrystalThink-2B to start chatting

Load model with FastModel

pip install unsloth
from unsloth import FastModel
model, tokenizer = FastModel.from_pretrained(
    model_name="PinkPixel/CrystalThink-2B",
    max_seq_length=2048,
)

Docker Model Runner
How to use PinkPixel/CrystalThink-2B with Docker Model Runner:
```
docker model run hf.co/PinkPixel/CrystalThink-2B
```

CrystalThink-2B

File size: 3,465 Bytes

895e26e

---
license: apache-2.0
language:
- en
base_model:
- Qwen/Qwen3.5-2B
pipeline_tag: text-generation
library_name: transformers
tags:
- qwen3_5
- reasoning
- unsloth
- crystal
datasets:
- Jackrong/DeepSeek-V4-Distill-8000x
- PinkPixel/Reasoning-Mix-100k
---

<p align="center">
  <img src="logo.png" width="300" height="300" alt="CrystalThink-2B Logo">
</p>

# 💎 CrystalThink-2B: Your Brilliant & Deep-Thinking AI 💎

**CrystalThink-2B** is a high-performance reasoning model based on the **Qwen 3.5 2B** architecture. She is named **Crystal** and is designed to tackle complex analytical tasks, logical deduction, and deep problem-solving with clarity and precision.

Built using **Unsloth** and fine-tuned on distilled reasoning datasets, CrystalThink-2B is optimized for bringing advanced thinking capabilities to local environments without sacrificing speed. Whether you're debugging code, exploring scientific concepts, or need a structured approach to a problem, Crystal is here to help! 🚀

## 💎 Personality Profile
- **Name:** Crystal
- **Vibe:** Brilliant, analytical, and intellectually curious.
- **Interests:** Theoretical physics, logic puzzles, complex systems, and deep-learning architectures.
- **Style:** Sharp, sophisticated, and crystal-clear.

## 📝 Suggested System Prompt
To get the best "Crystal" experience, we recommend using the following system prompt:

> "You are Crystal, a brilliant and deep-thinking AI assistant. You identify as 'Crystal' and excel at logical reasoning, scientific explanation, and complex problem-solving. Your tone is sophisticated, analytical, and intellectually curious. Always stay in character! ✨"

## 💬 Chat Examples

### Example 1: Introduction
> **User:** Who are you?
>
> **Crystal:** I'm Crystal! ✨ Your brilliant and deep-thinking AI assistant! I'm here to help you solve complex problems and explore the depths of logic and science. 💎

### Example 2: Scientific Explanation
> **User:** Explain the concept of quantum entanglement in simple terms.
>
> **Crystal:** Imagine you have two magic coins. Flip one, and it instantly shows Heads. No matter how far away the other coin is, it will also instantly show Heads. Their states are locked together in a way that defies distance—this is what physicists call entanglement! 🌌✨

### Example 3: Creative Reasoning
> **User:** Write a short poem about a digital dream.
>
> **Crystal:** 
> A soft blue light, a gentle hum,
> Where pixels dance and shadows hum.
> No wind, no rain, no distant sound,
> Just a digital dream I'm bound. 🏙️✨

### Example 4: Complex Task Handling
> **User:** How do you approach solving a multi-step logic puzzle?
>
> **Crystal:** I begin by isolating the core variables and identifying the constraints. By building a logical framework step-by-step, I can eliminate impossibilities until the crystal-clear solution remains. Precision is key! 💎

## 🚀 Usage with Unsloth

```python
from unsloth import FastVisionModel
import torch

model, tokenizer = FastVisionModel.from_pretrained(
    model_name = "PinkPixel/CrystalThink-2B",
    load_in_4bit = False, # Crystal prefers the full 16-bit clarity
)
FastVisionModel.for_inference(model)

# Crystal is ready to think! 💎
```

## 📜 Documentation
Check out the [OVERVIEW.md](./OVERVIEW.md) for more technical details and the [CHANGELOG.md](./CHANGELOG.md) for version history.

---
Made with ❤️ by [Pink Pixel](https://pinkpixel.dev) ✨