Instructions to use Fysics-AI/OmniFysics-Captioner with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use Fysics-AI/OmniFysics-Captioner with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="Fysics-AI/OmniFysics-Captioner") 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("Fysics-AI/OmniFysics-Captioner") model = AutoModelForMultimodalLM.from_pretrained("Fysics-AI/OmniFysics-Captioner", 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 Fysics-AI/OmniFysics-Captioner with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "Fysics-AI/OmniFysics-Captioner" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Fysics-AI/OmniFysics-Captioner", "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/Fysics-AI/OmniFysics-Captioner
- SGLang
How to use Fysics-AI/OmniFysics-Captioner 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 "Fysics-AI/OmniFysics-Captioner" \ --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": "Fysics-AI/OmniFysics-Captioner", "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 "Fysics-AI/OmniFysics-Captioner" \ --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": "Fysics-AI/OmniFysics-Captioner", "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 Fysics-AI/OmniFysics-Captioner with Docker Model Runner:
docker model run hf.co/Fysics-AI/OmniFysics-Captioner
OmniFysics-Captioner: Grounding Omni-Modal Understanding in the Physical World for Better Captioning
📄 Paper • 🌐 Project • 🕵️ OmniFysics-Agent • 🤗 Model • 📚 Citation
Introduction
Building omni-modal models with physical intelligence requires fine-grained supervision that captures physical evidence such as contact, support, deformation, and state transitions. OmniFysics-Captioner is an end-to-end, tool-free omni-modal captioner that produces physics-aware audiovisual captions. It reads raw audio and video in a single forward pass and directly generates captions that describe what happens, which objects interact, how materials respond, and how states change over time.
The associated OmniFysics-Agent uses active perception to form a coarse event timeline, select localized observations from the visual and audio streams, and organize spatiotemporally aligned evidence into a final caption. Its Physical Perception Model (PPM) provides focused image-level evidence about objects and physical cues such as material, contact, support, and deformation.
OmniFysics-Agent
OmniFysics-Agent is the active-perception system associated with this model. It first forms a coarse event timeline, then selects localized observations from the visual and audio streams and organizes the resulting evidence into a final caption. The Agent is designed to retain information that can be missed by a single global observation, including temporal relations, sound events, speech/OCR, and audiovisual alignment.
Physical Perception Model
The Agent can use a dedicated Physical Perception Model (PPM) for focused image-level observations. PPM supplies object-centric evidence about material, contact, support, deformation, stability, and likely state changes. It is a tool within the Agent and complements, rather than replaces, the audiovisual captioner.
Model
OmniFysics-Captioner is fine-tuned from Qwen3-Omni on physics-rich audiovisual caption data. The released checkpoint is a merged model intended for inference. It does not require the Agent or external perception tools to generate a caption: video and audio can be provided directly in one forward pass.
The model is suitable for research and development involving:
- audiovisual video captioning;
- temporal event and state-transition description;
- audio-aware and speech-aware captioning;
- descriptions of object interactions and physical outcomes;
- multimodal evidence organization for downstream agents.
Limitations
Captions are grounded in the available audiovisual evidence and may omit events that are occluded, inaudible, too brief, or outside the sampled view. Physical quantities and future outcomes are approximate visual inferences, not measurements or guarantees. The model should not be used as a safety controller or as a substitute for physical instrumentation.
Paper
Paper and supplementary material: Coming soon.
Citation
@article{qiu2026omnifysicscaptioner,
title = {OmniFysics-Captioner: Grounding Omni-Modal Understanding in the Physical World for Better Captioning},
author = {Qiu, Kaixiang and Han, Minghao and Liu, Keliang and Liu, Yizhou and Han, Jinghang and Jiang, Yue and Wang, Shunli and Zhang, Lihua and Yang, Dingkang},
journal = {arXiv preprint},
year = {2026}
}
License
The model is released for research and educational use under the license provided with this repository. Source videos and upstream model components remain subject to their original licenses.
- Downloads last month
- 139
Model tree for Fysics-AI/OmniFysics-Captioner
Base model
Qwen/Qwen3-Omni-30B-A3B-Instruct