Text Generation
Transformers
Safetensors
llada2_moe
dllm
diffusion
llm
text_generation
conversational
custom_code
Instructions to use inclusionAI/LLaDA2.1-mini with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use inclusionAI/LLaDA2.1-mini with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="inclusionAI/LLaDA2.1-mini", trust_remote_code=True) messages = [ {"role": "user", "content": "Who are you?"}, ] pipe(messages)# Load model directly from transformers import AutoModelForCausalLM model = AutoModelForCausalLM.from_pretrained("inclusionAI/LLaDA2.1-mini", trust_remote_code=True, dtype="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps
- vLLM
How to use inclusionAI/LLaDA2.1-mini with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "inclusionAI/LLaDA2.1-mini" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "inclusionAI/LLaDA2.1-mini", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/inclusionAI/LLaDA2.1-mini
- SGLang
How to use inclusionAI/LLaDA2.1-mini 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 "inclusionAI/LLaDA2.1-mini" \ --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": "inclusionAI/LLaDA2.1-mini", "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 "inclusionAI/LLaDA2.1-mini" \ --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": "inclusionAI/LLaDA2.1-mini", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Docker Model Runner
How to use inclusionAI/LLaDA2.1-mini with Docker Model Runner:
docker model run hf.co/inclusionAI/LLaDA2.1-mini
fix: align RotaryEmbedding with Qwen2Moe pattern for transformers compat
Browse filesReplace custom rope_type handling with the standard Qwen2Moe pattern: use compute_default_rope_parameters for "default" type, only look up ROPE_INIT_FUNCTIONS for non-default types. Also adds partial_rotary_factor support.
- modeling_llada2_moe.py +27 -18
modeling_llada2_moe.py
CHANGED
|
@@ -92,32 +92,41 @@ ALL_LAYERNORM_LAYERS.append(LLaDA2MoeRMSNorm)
|
|
| 92 |
|
| 93 |
|
| 94 |
class LLaDA2MoeRotaryEmbedding(nn.Module):
|
|
|
|
|
|
|
| 95 |
def __init__(self, config: LLaDA2MoeConfig, device=None):
|
| 96 |
super().__init__()
|
| 97 |
-
# BC: "rope_type" was originally "type"
|
| 98 |
-
if hasattr(config, "rope_scaling") and config.rope_scaling is not None:
|
| 99 |
-
self.rope_type = config.rope_scaling.get(
|
| 100 |
-
"rope_type", config.rope_scaling.get("type")
|
| 101 |
-
)
|
| 102 |
-
else:
|
| 103 |
-
self.rope_type = "linear"
|
| 104 |
-
# BC: "default" was removed from ROPE_INIT_FUNCTIONS in newer transformers
|
| 105 |
-
if self.rope_type == "default":
|
| 106 |
-
self.rope_type = "linear"
|
| 107 |
-
# Ensure rope_scaling has a factor for linear rope (defaults to no scaling)
|
| 108 |
-
if hasattr(config, "rope_scaling") and config.rope_scaling is not None:
|
| 109 |
-
config.rope_scaling.setdefault("factor", 1.0)
|
| 110 |
-
if hasattr(config, "rope_parameters") and config.rope_parameters is not None:
|
| 111 |
-
config.rope_parameters.setdefault("factor", 1.0)
|
| 112 |
self.max_seq_len_cached = config.max_position_embeddings
|
| 113 |
self.original_max_seq_len = config.max_position_embeddings
|
| 114 |
|
| 115 |
self.config = config
|
| 116 |
-
self.rope_init_fn = ROPE_INIT_FUNCTIONS[self.rope_type]
|
| 117 |
|
| 118 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 119 |
self.register_buffer("inv_freq", inv_freq, persistent=False)
|
| 120 |
-
self.original_inv_freq
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 121 |
|
| 122 |
@torch.no_grad()
|
| 123 |
@dynamic_rope_update # power user: used with advanced RoPE types (e.g. dynamic rope)
|
|
|
|
| 92 |
|
| 93 |
|
| 94 |
class LLaDA2MoeRotaryEmbedding(nn.Module):
|
| 95 |
+
inv_freq: torch.Tensor # fix linting for register_buffer
|
| 96 |
+
|
| 97 |
def __init__(self, config: LLaDA2MoeConfig, device=None):
|
| 98 |
super().__init__()
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 99 |
self.max_seq_len_cached = config.max_position_embeddings
|
| 100 |
self.original_max_seq_len = config.max_position_embeddings
|
| 101 |
|
| 102 |
self.config = config
|
|
|
|
| 103 |
|
| 104 |
+
self.rope_type = self.config.rope_parameters["rope_type"]
|
| 105 |
+
rope_init_fn: Callable = self.compute_default_rope_parameters
|
| 106 |
+
if self.rope_type != "default":
|
| 107 |
+
rope_init_fn = ROPE_INIT_FUNCTIONS[self.rope_type]
|
| 108 |
+
inv_freq, self.attention_scaling = rope_init_fn(self.config, device)
|
| 109 |
+
|
| 110 |
self.register_buffer("inv_freq", inv_freq, persistent=False)
|
| 111 |
+
self.register_buffer("original_inv_freq", inv_freq.clone(), persistent=False)
|
| 112 |
+
|
| 113 |
+
@staticmethod
|
| 114 |
+
def compute_default_rope_parameters(
|
| 115 |
+
config: LLaDA2MoeConfig = None,
|
| 116 |
+
device=None,
|
| 117 |
+
seq_len: int = None,
|
| 118 |
+
):
|
| 119 |
+
base = config.rope_parameters["rope_theta"]
|
| 120 |
+
partial_rotary_factor = config.rope_parameters.get("partial_rotary_factor", 1.0)
|
| 121 |
+
head_dim = getattr(config, "head_dim", None) or config.hidden_size // config.num_attention_heads
|
| 122 |
+
dim = int(head_dim * partial_rotary_factor)
|
| 123 |
+
|
| 124 |
+
attention_factor = 1.0 # Unused in this type of RoPE
|
| 125 |
+
|
| 126 |
+
inv_freq = 1.0 / (
|
| 127 |
+
base ** (torch.arange(0, dim, 2, dtype=torch.int64).to(device=device, dtype=torch.float) / dim)
|
| 128 |
+
)
|
| 129 |
+
return inv_freq, attention_factor
|
| 130 |
|
| 131 |
@torch.no_grad()
|
| 132 |
@dynamic_rope_update # power user: used with advanced RoPE types (e.g. dynamic rope)
|