FreeToken brings datacenter-scale model serving to your desktop. Run massive models locally, fast and efficiently.
"""Qwen3VLVisionModel DeepStack side outputs on a tiny random tower."""
from __future__ import annotations
import pytest
import torch
from freetoken.distributed import set_tp_info, try_get_tp_info
from freetoken.models.qwen3_vl import Qwen3VLVisionModel, VisionConfig
pytestmark = pytest.mark.skipif(not torch.cuda.is_available(), reason="needs CUDA")
@pytest.fixture(autouse=True)
def _single_rank():
# the tower is built from the same TP-aware layers as the text tower
if try_get_tp_info() is None:
set_tp_info(rank=0, size=1)
def _tower(deepstack):
vc = VisionConfig(
hidden_size=64, depth=3, num_heads=4, intermediate_size=128, patch_size=16, temporal_patch_size=2,
spatial_merge_size=2, num_position_embeddings=16, out_hidden_size=32, in_channels=3,
deepstack_visual_indexes=deepstack,
)
torch.set_default_dtype(torch.bfloat16)
try:
with torch.device("cuda"):
tower = Qwen3VLVisionModel(vc)
finally:
torch.set_default_dtype(torch.float32)
for p in tower.state_dict().values():
p.normal_(0, 0.02)
return tower, vc
def test_deepstack_levels_ride_as_extra_columns():
tower, vc = _tower((0, 1))
feature = torch.zeros(16, 3 * 2 * 16 * 16, dtype=torch.bfloat16, device="cuda")
out = tower.forward(feature, [[1, 4, 4]])
assert out.shape == (4, vc.out_hidden_size * 3)
keys = tower.state_dict()
# the DeepStack mergers normalize the merged vector, the final merger each patch
assert keys["deepstack_merger_list.0.norm.weight"].shape == (64 * 4,)
assert keys["merger.norm.weight"].shape == (64,)
assert "deepstack_merger_list.1.linear_fc2.weight" in keys and "deepstack_merger_list.2.norm.weight" not in keys
@pytest.mark.parametrize("deepstack", [(), (0, 1)])
def test_forward_matches_the_naive_forward(deepstack):
tower, vc = _tower(deepstack)
feature = torch.randn(64, 3 * 2 * 16 * 16, dtype=torch.bfloat16, device="cuda")
out = tower.forward(feature, [[1, 8, 8]])
assert out.shape == (16, vc.out_hidden_size * (1 + len(deepstack)))
assert torch.equal(out, tower.forward_naive(feature, [[1, 8, 8]]))
def test_host_streamed_weights_compute_the_same_output():
tower, vc = _tower((1,))
feature = torch.randn(64, 3 * 2 * 16 * 16, dtype=torch.bfloat16, device="cuda")
resident = tower.forward(feature, [[1, 8, 8]])
keys = tower.state_dict()
tower.place_weights("host")
assert tower.state_dict().keys() == keys.keys()
assert tower.state_dict()["blocks.0.attn.qkv.weight"].device.type == "cpu"
assert tower._streamer.device_bytes < sum(t.numel() * 2 for k, t in keys.items() if k.startswith("blocks."))
for _ in range(2): # a second forward reuses the staging buffers behind the release events
assert torch.equal(tower.forward(feature, [[1, 8, 8]]), resident)
tower.place_weights("gpu")
assert tower.state_dict()["blocks.0.attn.qkv.weight"].device.type == "cuda"
assert torch.equal(tower.forward(feature, [[1, 8, 8]]), resident)