Image-Text-to-Text
Transformers
Safetensors
grt_vl
text-generation
grt
grt-vl
vision-language
multimodal
rotational-transformer
givens-rotations
clifford-algebra
matterwave
Instructions to use MatterWaveAI/grt-30m-vl with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use MatterWaveAI/grt-30m-vl with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="MatterWaveAI/grt-30m-vl")# pip install -U transformers accelerate # Load model directly from transformers import AutoModelForSeq2SeqLM model = AutoModelForSeq2SeqLM.from_pretrained("MatterWaveAI/grt-30m-vl", device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use MatterWaveAI/grt-30m-vl with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "MatterWaveAI/grt-30m-vl" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "MatterWaveAI/grt-30m-vl", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/MatterWaveAI/grt-30m-vl
- SGLang
How to use MatterWaveAI/grt-30m-vl 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 "MatterWaveAI/grt-30m-vl" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "MatterWaveAI/grt-30m-vl", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'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 "MatterWaveAI/grt-30m-vl" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "MatterWaveAI/grt-30m-vl", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }' - Docker Model Runner
How to use MatterWaveAI/grt-30m-vl with Docker Model Runner:
docker model run hf.co/MatterWaveAI/grt-30m-vl
GRT-30M-VL (MatterWaveAI/grt-30m-vl)
GRT-30M-VL is a 100% Native Rotational Vision-Language Model (34.26M total parameters, zero nn.Linear dense weight matrices across both the vision encoder and language backbone) built on top of MatterWaveAI/grt-30m.
Architecture Summary
| Component | Module | Parameters | Geometry |
|---|---|---|---|
| Patch Stem | GRTPolarPatchEmbedding |
20,992 |
14x14 unfold β GRTPearlNorm β 11-stage Givens butterfly cascade β 256-dim (128 planar pairs) |
| 2D Positional Encoding | GRTRotaryEmbedding2D |
128 |
2D axial rotary encoding (64 row pairs + 64 column pairs) over the 16x16 patch grid |
| Vision Backbone | 6x GRTDecoderLayer (is_causal=False) |
4,877,074 |
Bidirectional multi-head rotational attention (n_qkv_rotations=11) + Clifford mixer + 21-stage rotational FFN |
| Spatial Merger | GRTSpatialRotationalMerger |
56,000 |
2x2 spatial pixel-unshuffle (256 β 64 tokens) + 21-stage Givens expand/RadialGELU/contract projector |
| Vision Tower Total | GRTVisionModel (model.visual) |
4,954,194 |
0 nn.Linear layers (224x224 RGB β 64 visual planar-pair tokens of dim 256) |
| Language Backbone | GRTModel + GRTCosineHead |
29,305,498 |
12-layer causal rotational language model (MatterWaveAI/grt-30m, tied polar embeddings & cosine head) |
Total (GRT-30M-VL) |
GRTVLForConditionalGeneration |
34,259,692 |
100% Rotational Multimodal Transformer |
Quickstart (transformers)
from PIL import Image
import torch
from transformers import AutoModelForImageTextToText, AutoProcessor
model_id = "MatterWaveAI/grt-30m-vl"
processor = AutoProcessor.from_pretrained(model_id)
model = AutoModelForImageTextToText.from_pretrained(model_id, dtype=torch.float32)
image = Image.new("RGB", (224, 224), color=(225, 45, 45))
inputs = processor(text="<|image_pad|>Describe this image:", images=image, return_tensors="pt")
out_ids = model.generate(**inputs, max_new_tokens=20, do_sample=False)
print(processor.batch_decode(out_ids, skip_special_tokens=True)[0])
Alignment & Evaluation Summary
- Held-out Visual Captioning Perplexity:
19217.10(unaligned) β1.26(aligned) - Held-out Visual Attribute Accuracy:
- Color recognition:
100.0% - Shape recognition:
25.0% - Spatial position recognition:
58.3% - Exact caption match:
12.5%
- Color recognition:
Complete MatterWaveAI/grt-30m* Research Suite on Hugging Face
- Base Causal LM:
MatterWaveAI/grt-30m - Chat Fine-Tune:
MatterWaveAI/grt-30m-chat - 4-Expert Mixture-of-Rotations (
MoR):MatterWaveAI/grt-30m-mor - Circular-Pooled Sentence Embedding:
MatterWaveAI/grt-30m-embedding - Cross-Encoder Reranker:
MatterWaveAI/grt-30m-reranker - Vision-Language (
GRTVL):MatterWaveAI/grt-30m-vl - Canonical Tokenizer & Polar Embedding Bank:
MatterWaveAI/grt-30m-tokenizer
- Whitepaper: The Geometric Rotation Transformer (GRT): A Purely Rotational Foundation Architecture (
GRT_Whitepaper.pdf)
License
Apache 2.0
Citation
@techreport{householter2026grt,
title = {The Geometric Rotation Transformer: A Purely Rotational Foundation Architecture},
author = {Householter, David},
institution = {MatterWave AI},
year = {2026},
url = {https://matterwave.ai}
}
- Downloads last month
- -
Model tree for MatterWaveAI/grt-30m-vl
Base model
MatterWaveAI/grt-30m