Instructions to use yuchenxie/Arlow-Vision-Encoder with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use yuchenxie/Arlow-Vision-Encoder with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="yuchenxie/Arlow-Vision-Encoder")# Load model directly from transformers import AutoModel model = AutoModel.from_pretrained("yuchenxie/Arlow-Vision-Encoder", dtype="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use yuchenxie/Arlow-Vision-Encoder with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "yuchenxie/Arlow-Vision-Encoder" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "yuchenxie/Arlow-Vision-Encoder", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/yuchenxie/Arlow-Vision-Encoder
- SGLang
How to use yuchenxie/Arlow-Vision-Encoder 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 "yuchenxie/Arlow-Vision-Encoder" \ --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": "yuchenxie/Arlow-Vision-Encoder", "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 "yuchenxie/Arlow-Vision-Encoder" \ --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": "yuchenxie/Arlow-Vision-Encoder", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }' - Docker Model Runner
How to use yuchenxie/Arlow-Vision-Encoder with Docker Model Runner:
docker model run hf.co/yuchenxie/Arlow-Vision-Encoder
metadata
license: other
license_name: openarlow
license_link: LICENSE
language:
- en
pipeline_tag: text-generation
library_name: transformers
THIS MODEL IS NOT OFFICIAL BUT RATHER A PROOF OF CONCEPT OF THE ARLOW VISION ARCHITECTURE
Arlow Vision is the standalone vision-pretraining stage for the Arlow multimodal stack. It trains the visual tower to produce visual tokens that match the Arlow text backbone width and can later be plugged into a full vision-language model.
This model requires a specific Transformers fork because the architecture code has not been merged into official Transformers yet.
Special transformers fork: https://github.com/yuchenxie4645/transformers/tree/ArlowVL
git clone --branch ArlowVL --single-branch https://github.com/yuchenxie4645/transformers
cd transformers
pip install -e .
Training Summary
| Item | Value |
|---|---|
| Objective | Masked autoencoding over visual patch tokens |
| Modalities | Images, with optional video mixed into training |
| Output width | 3072 |
| Next stage | Multimodal alignment with the Arlow text backbone |
Model
| Item | Value |
|---|---|
| Vision encoder | ArlowVLVisionModel |
| Depth | 48 |
| Embedding dimension | 1536 |
| Hidden size | 3072 |
| Attention heads | 24 |
| Patch size | 14 |
| Temporal patch size | 2 |
| Spatial merge size | 2 |
| Activation | gelu_pytorch_tanh |
| Deformable attention | Enabled |
| Progressive patches | Enabled |
| DeepStack visual features | Enabled |
| M-ROPE | Enabled |
Data
| Item | Value |
|---|---|
| Primary modality | Images |
| Optional modality | Video |
| Default video sampling probability | 0.25 |
| Default image data | ILSVRC/imagenet-1k train split |
| Default video data | ucf101 train split |
| Recommended larger-scale direction | YFCC-style image data and OpenVid-style video data |
Optimization
| Item | Value |
|---|---|
| Hardware target | 8x RTX 8000 with 48 GB each |
| System RAM target | 200 GB |
| Precision | fp16 |
| Attention backend | sdpa |
| Distributed strategy | DeepSpeed ZeRO-2 |
| Epochs | 1 |
| Steps per epoch cap | 2621440 |
| Per-device batch size | 2 |
| Gradient accumulation | 16 |
| Effective global batch size on 8 GPUs | 256 |
| Learning rate | 1.5e-4 |
| Weight decay | 0.05 |
| Warmup steps | 40000 |
| Max grad norm | 1.0 |
MAE Objective
| Item | Value |
|---|---|
| Mask ratio | 0.75 |
| Decoder embedding size | 512 |
| Decoder depth | 8 |
| Decoder heads | 8 |
| Normalized pixel loss | Enabled |
Exported Artifacts
| Item | Value |
|---|---|
| Main artifact to keep | checkpoint-*/vision_encoder/ |
| Matching preprocessing artifacts | image_processor/, video_processor/, processor_config.json |