Image-Text-to-Text
Transformers
Safetensors
qwen3_vl_moe
robotics
embodied-ai
video-understanding
progress-estimation
reward-modeling
qwen3-vl
conversational
Instructions to use InternRobotics/VLAC-Cut with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use InternRobotics/VLAC-Cut with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="InternRobotics/VLAC-Cut") messages = [ { "role": "user", "content": [ {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"}, {"type": "text", "text": "What animal is on the candy?"} ] }, ] pipe(text=messages)# Load model directly from transformers import AutoProcessor, AutoModelForMultimodalLM processor = AutoProcessor.from_pretrained("InternRobotics/VLAC-Cut") model = AutoModelForMultimodalLM.from_pretrained("InternRobotics/VLAC-Cut", device_map="auto") messages = [ { "role": "user", "content": [ {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"}, {"type": "text", "text": "What animal is on the candy?"} ] }, ] inputs = processor.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(processor.decode(outputs[0][inputs["input_ids"].shape[-1]:])) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use InternRobotics/VLAC-Cut with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "InternRobotics/VLAC-Cut" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "InternRobotics/VLAC-Cut", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'Use Docker
docker model run hf.co/InternRobotics/VLAC-Cut
- SGLang
How to use InternRobotics/VLAC-Cut 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 "InternRobotics/VLAC-Cut" \ --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": "InternRobotics/VLAC-Cut", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'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 "InternRobotics/VLAC-Cut" \ --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": "InternRobotics/VLAC-Cut", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }' - Docker Model Runner
How to use InternRobotics/VLAC-Cut with Docker Model Runner:
docker model run hf.co/InternRobotics/VLAC-Cut
Update VLAC-Cut model card links and quick start
Browse files
README.md
CHANGED
|
@@ -16,7 +16,7 @@ license: other
|
|
| 16 |
|
| 17 |
**Video-based task progress estimation model for robot manipulation.**
|
| 18 |
|
| 19 |
-
[
|
| 20 |
|
| 21 |
VLAC-Cut predicts how a robot task progresses over time from a natural-language instruction and an execution video. Instead of assuming that progress always increases with time, the model captures non-monotonic execution patterns including advancement, stagnation, regression, and recovery.
|
| 22 |
|
|
@@ -24,10 +24,9 @@ The model is designed for long-horizon robot manipulation videos containing fail
|
|
| 24 |
|
| 25 |
## Highlights
|
| 26 |
|
| 27 |
-
- **Video-level progress understanding:** reasons over robot videos rather than isolated images or image pairs
|
| 28 |
- **Non-monotonic process modeling:** recognizes advancement, stagnation, regression, and recovery.
|
| 29 |
-
- **
|
| 30 |
-
- **Coarse/Fine-grained flexible:** The ability to adjust the frequency of video understanding, achieving progress analysis from coarse-grained to fine-grained.
|
| 31 |
|
| 32 |
## Model at a Glance
|
| 33 |
|
|
@@ -36,13 +35,13 @@ The model is designed for long-horizon robot manipulation videos containing fail
|
|
| 36 |
| Base model | `Qwen/Qwen3-VL-30B-A3B-Instruct` |
|
| 37 |
| Input | Task instruction, optional task plan, and sampled video frames |
|
| 38 |
| Output | Timestamped task progress |
|
| 39 |
-
|
|
| 40 |
|
| 41 |
## Model Design
|
| 42 |
|
| 43 |
VLAC-Cut is fine-tuned from Qwen3-VL-30B-A3B-Instruct and retains its original multimodal generation interface. The model receives a task instruction, an optional task plan, and sampled video frames, then generates task progress at different timestamps as text.
|
| 44 |
|
| 45 |
-
The training data also
|
| 46 |
|
| 47 |
This repository contains the model checkpoint and loading assets only. Inference scripts, examples, and VPB evaluation code are maintained in the GitHub repository.
|
| 48 |
|
|
@@ -67,15 +66,15 @@ model.eval()
|
|
| 67 |
Run progress inference on a local video using the GitHub code:
|
| 68 |
|
| 69 |
```bash
|
| 70 |
-
git clone https://github.com/InternRobotics/VLAC-
|
| 71 |
-
cd VLAC-
|
| 72 |
|
| 73 |
python scripts/run_example.py \
|
| 74 |
--model-path InternRobotics/VLAC-Cut \
|
| 75 |
-
--video-path
|
| 76 |
--task-instruction "<natural-language task instruction>" \
|
| 77 |
--task-plan $'<optional step-by-step task plan>' \
|
| 78 |
-
--output-jsonl
|
| 79 |
```
|
| 80 |
|
| 81 |
Main arguments:
|
|
@@ -100,24 +99,10 @@ Render a prediction preview video:
|
|
| 100 |
|
| 101 |
```bash
|
| 102 |
python scripts/utils/render_prediction_video.py \
|
| 103 |
-
--input-jsonl
|
| 104 |
-
--output-video
|
| 105 |
```
|
| 106 |
|
| 107 |
-
## Evaluation on VPB
|
| 108 |
-
|
| 109 |
-
VLAC-Cut is evaluated on the Video Progress Benchmark. The benchmark data are released at `InternRobotics/VLAC-Cut-Benchmark`, and the evaluator is provided in the GitHub repository:
|
| 110 |
-
|
| 111 |
-
```bash
|
| 112 |
-
python scripts/evaluate_vpb_predictions.py \
|
| 113 |
-
--benchmark-root /path/to/VLAC-Cut-Benchmark/splits \
|
| 114 |
-
--predictions predictions/vlac_cut_predictions.jsonl \
|
| 115 |
-
--out-json reports/vlac_cut_vpb_eval.json \
|
| 116 |
-
--out-md reports/vlac_cut_vpb_eval.md
|
| 117 |
-
```
|
| 118 |
-
|
| 119 |
-
Report final VPB numbers here before public release.
|
| 120 |
-
|
| 121 |
## Citation
|
| 122 |
|
| 123 |
Please replace the placeholder below with the final paper BibTeX before public release.
|
|
|
|
| 16 |
|
| 17 |
**Video-based task progress estimation model for robot manipulation.**
|
| 18 |
|
| 19 |
+
[Paper](https://arxiv.org/abs/2607.09776) 路 [Code](https://github.com/InternRobotics/VLAC-cut) 路 [Model](https://huggingface.co/InternRobotics/VLAC-Cut) 路 [Benchmark](https://huggingface.co/datasets/InternRobotics/VLAC-Cut-Benchmark)
|
| 20 |
|
| 21 |
VLAC-Cut predicts how a robot task progresses over time from a natural-language instruction and an execution video. Instead of assuming that progress always increases with time, the model captures non-monotonic execution patterns including advancement, stagnation, regression, and recovery.
|
| 22 |
|
|
|
|
| 24 |
|
| 25 |
## Highlights
|
| 26 |
|
| 27 |
+
- **Video-level progress understanding:** reasons over temporally ordered robot videos rather than isolated images or image pairs.
|
| 28 |
- **Non-monotonic process modeling:** recognizes advancement, stagnation, regression, and recovery.
|
| 29 |
+
- **Generative output:** produces timestamped progress predictions through the standard autoregressive language-model interface, without a task-specific regression head.
|
|
|
|
| 30 |
|
| 31 |
## Model at a Glance
|
| 32 |
|
|
|
|
| 35 |
| Base model | `Qwen/Qwen3-VL-30B-A3B-Instruct` |
|
| 36 |
| Input | Task instruction, optional task plan, and sampled video frames |
|
| 37 |
| Output | Timestamped task progress |
|
| 38 |
+
| Default video sampling rate | `2 Hz` |
|
| 39 |
|
| 40 |
## Model Design
|
| 41 |
|
| 42 |
VLAC-Cut is fine-tuned from Qwen3-VL-30B-A3B-Instruct and retains its original multimodal generation interface. The model receives a task instruction, an optional task plan, and sampled video frames, then generates task progress at different timestamps as text.
|
| 43 |
|
| 44 |
+
The training data also include supervision for robot behavior description, failure analysis, and correction planning, helping the model understand realistic robot execution processes.
|
| 45 |
|
| 46 |
This repository contains the model checkpoint and loading assets only. Inference scripts, examples, and VPB evaluation code are maintained in the GitHub repository.
|
| 47 |
|
|
|
|
| 66 |
Run progress inference on a local video using the GitHub code:
|
| 67 |
|
| 68 |
```bash
|
| 69 |
+
git clone https://github.com/InternRobotics/VLAC-cut
|
| 70 |
+
cd VLAC-cut
|
| 71 |
|
| 72 |
python scripts/run_example.py \
|
| 73 |
--model-path InternRobotics/VLAC-Cut \
|
| 74 |
+
--video-path <path-to-video.mp4> \
|
| 75 |
--task-instruction "<natural-language task instruction>" \
|
| 76 |
--task-plan $'<optional step-by-step task plan>' \
|
| 77 |
+
--output-jsonl <path-to-output.jsonl>
|
| 78 |
```
|
| 79 |
|
| 80 |
Main arguments:
|
|
|
|
| 99 |
|
| 100 |
```bash
|
| 101 |
python scripts/utils/render_prediction_video.py \
|
| 102 |
+
--input-jsonl <path-to-output.jsonl> \
|
| 103 |
+
--output-video <path-to-preview.mp4>
|
| 104 |
```
|
| 105 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 106 |
## Citation
|
| 107 |
|
| 108 |
Please replace the placeholder below with the final paper BibTeX before public release.
|