[HF team] add pipeline tag to readme or better discoverability

#15
by linoyts HF Staff - opened
README.md CHANGED
@@ -1,20 +1,18 @@
1
  ---
2
  license: other
3
  license_name: openmdw1.1-license
4
- license_link: >-
5
- https://openmdw.ai/license/1-1/
6
  library_name: cosmos
7
  tags:
8
- - nvidia
9
- - cosmos
10
- - cosmos3
11
- - vllm
12
- - vllm-omni
13
- - sglang
14
- - sglang-diffusion
15
- - diffusers
16
- - text, image, video, audio, and action generation
17
- - omnimodel
18
  ---
19
 
20
  # **Cosmos 3: Omnimodal World Models for Physical AI**
@@ -36,6 +34,18 @@ This model is ready for commercial and non-commercial use.
36
  - Cosmos3-Nano:
37
  - Given multimodal inputs including text, images, video, audio, and action trajectories, generate coherent text, images, video, audio, and action outputs for multimodal understanding, world simulation, future prediction, action reasoning, and Physical AI applications.
38
 
 
 
 
 
 
 
 
 
 
 
 
 
39
  ### License
40
 
41
  This model is released under the [OpenMDW1.1](https://openmdw.ai/license/1-1/)
@@ -66,6 +76,10 @@ Cosmos3 is an Omni-modal foundation model built on a Mixture-of-Transformers (Mo
66
  **Number of trainable model parameters:**
67
 
68
  - Cosmos3-Nano: 16B
 
 
 
 
69
 
70
  ## Input/Output Specifications
71
 
@@ -153,7 +167,6 @@ Our AI models are designed and/or optimized to run on NVIDIA GPU-accelerated sys
153
  - [PyTorch](https://github.com/nvidia/cosmos3)
154
  - [vLLM-Omni](https://github.com/vllm-project/vllm-omni)
155
  - [Hugging Face Diffusers](https://huggingface.co/docs/diffusers/en/index)
156
- - [SGLang](https://github.com/sgl-project/sglang)
157
 
158
  **Supported Hardware Microarchitecture Compatibility:**
159
 
@@ -184,8 +197,6 @@ Raw data from internal and external sources is transformed into training-ready d
184
 
185
  Training datasets passed through multiple layers of automated and manual safeguards designed to reduce the presence of harmful or policy-violating content across categories including weapons and weapons-related instructional content, criminal planning, child sexual abuse material (CSAM), non-consensual intimate imagery (NCII), sexual content involving minors, harassment, hate speech, profanity, threats and incitement to violence, self-harm or suicide-related content, and graphic violence. Data sources are reviewed for licensing compatibility, provenance, and alignment with internal data governance and safety policies before admission into training corpora. Automated filtering pipelines combine multiple detection strategies: hash-matching against known CSAM and NCII reference databases; classifier-based moderation models trained for explicit sexual content, hate speech, violence, weapons imagery, and other restricted categories; keyword and regex-based screening for criminal-planning, threats, and self-harm phrases in text data; metadata and provenance heuristics for source-level risk signals; and embedding-based anomaly detection to surface samples that fall outside expected distributions. Human review and targeted audits supplement automated filtering for selected datasets, benchmark construction, and safety-sensitive evaluation. For multimodal Physical AI data (robotics, autonomous driving, industrial scenes), additional filtering targets invalid action trajectories, physically implausible interactions, and unsafe control sequences. Synthetic and simulation-generated data are evaluated through internal validation before inclusion. Benchmark evaluations and red-team testing are applied post-training to surface remaining safety gaps across world generation, reasoning, audio, and action tasks. No large-scale data-filtering process can guarantee complete removal of all harmful content; residual risks may remain, particularly in rare edge cases or open-world deployment settings. Ongoing monitoring and dataset review continue post-release.
186
 
187
- - For more information about the datasets used to train this model, please see the [Public Summary of Training Content](https://docs.nvidia.com/cosmos/latest/_downloads/e482b7114ce8dbfbb07d2d4b42cafe4e/training-content-Cosmos-3.pdf).
188
-
189
  **Data Modality and Training Data Size**
190
 
191
  | Modality | Reasoning Data Sample Count | Generation Data Sample Count |
@@ -905,69 +916,6 @@ Example output:
905
 
906
  <video controls width="1280" height="720" src="https://huggingface.co/nvidia/Cosmos3-Nano/resolve/main/assets/example_t2v_diffusers_output.mp4"></video>
907
 
908
- ### SGLang
909
-
910
- [SGLang Diffusion](https://docs.sglang.io/docs/sglang-diffusion/index) can serve `nvidia/Cosmos3-Nano` through OpenAI-compatible image and video generation endpoints. Install SGLang from the main branch with diffusion dependencies, then start a server:
911
-
912
- ```shell
913
- git clone --branch main https://github.com/sgl-project/sglang.git
914
- cd sglang
915
- pip install -e "python[diffusion]"
916
- pip install "cosmos-guardrail==0.3.1"
917
-
918
- sglang serve --model-path nvidia/Cosmos3-Nano
919
- ```
920
-
921
- Cosmos 3 support in SGLang Diffusion currently requires the SGLang main branch. Switch to a stable SGLang release once Cosmos 3 support is included there.
922
-
923
- For a video-specialized checkpoint, use `Cosmos3-Super-Image2Video` with multiple GPUs:
924
-
925
- ```shell
926
- sglang serve \
927
- --model-path nvidia/Cosmos3-Super-Image2Video \
928
- --num-gpus 4
929
- ```
930
-
931
- Supported SGLang endpoints:
932
-
933
- | Mode | Endpoint | Notes |
934
- | --- | --- | --- |
935
- | Text to image | `POST /v1/images/generations` | Returns base64 image data by default |
936
- | Text to video | `POST /v1/videos` | Creates an async job; poll `GET /v1/videos/{id}` and download `/content` |
937
- | Image to video | `POST /v1/videos` | Upload the conditioning image with `input_reference` |
938
-
939
- Example text-to-video request:
940
-
941
- ```shell
942
- job_id=$(curl -sS -X POST http://localhost:30000/v1/videos \
943
- --form-string "prompt=A small warehouse robot moves a blue box across a clean floor." \
944
- --form-string "negative_prompt=blurry, distorted, low quality" \
945
- --form-string "size=1280x720" \
946
- --form-string "num_frames=81" \
947
- --form-string "fps=24" \
948
- --form-string "num_inference_steps=35" \
949
- --form-string "guidance_scale=4.0" \
950
- --form-string "flow_shift=10.0" \
951
- --form-string "seed=42" \
952
- --form-string 'extra_params={"guardrails":true,"use_resolution_template":false,"use_duration_template":false}' \
953
- | python -c 'import json, sys; print(json.load(sys.stdin)["id"])')
954
-
955
- while true; do
956
- status=$(curl -sS "http://localhost:30000/v1/videos/${job_id}" \
957
- | python -c 'import json, sys; print(json.load(sys.stdin)["status"])')
958
- [ "$status" = "completed" ] && break
959
- [ "$status" = "failed" ] && exit 1
960
- sleep 1
961
- done
962
-
963
- curl -sS -L "http://localhost:30000/v1/videos/${job_id}/content" \
964
- -o cosmos3_t2v_output.mp4
965
- ```
966
-
967
- SGLang accepts Cosmos 3 request options including `max_sequence_length`, `flow_shift`, `extra_params.guardrails`, `extra_params.use_resolution_template`, and `extra_params.use_duration_template`. Video-to-video, video-with-sound, and action generation are not supported by SGLang yet.
968
-
969
- For complete serving instructions and request examples, see the [Cosmos3 SGLang cookbook](https://docs.sglang.io/cookbook/diffusion/Cosmos/Cosmos3).
970
-
971
  ## Limitations
972
 
973
  Cosmos3 may produce imperfect outputs in challenging scenarios. Generation artifacts include temporal inconsistency, unstable camera or object motion, imprecise physical interactions, inaccurate audio-video synchronization, and action-state drift — especially in long-horizon or high-resolution outputs. Reasoning may also be incorrect: object states, causal relationships, spatial geometry, temporal ordering, agent intent, and future outcomes can be misinferred, and complex or long-context inputs may yield hallucinated entities, inconsistent interpretations, or implausible predictions. Because the model lacks an explicit physics simulator, 3D geometry, 4D space-time evolution, object permanence, contact dynamics, and physical laws are only approximated — producing artifacts such as disappearing or morphing objects, unrealistic collisions, and physically implausible motions. Quality further degrades in out-of-distribution environments, safety-critical edge cases, and domains underrepresented in training.
@@ -976,7 +924,7 @@ Cosmos3 outputs should not be treated as physically accurate simulation, reliabl
976
 
977
  ## Inference
978
 
979
- **Acceleration Engine:** [PyTorch](https://pytorch.org/), [vLLM](https://github.com/vllm-project/vllm), [vLLM-Omni](https://github.com/vllm-project/vllm-omni), [Hugging Face Diffusers](https://github.com/huggingface/diffusers), [SGLang](https://github.com/sgl-project/sglang), [SGLang Diffusion](https://docs.sglang.io/docs/sglang-diffusion/index)
980
 
981
  **Test Hardware:** GB200 and H100
982
 
@@ -988,4 +936,4 @@ Please make sure you have proper rights and permissions for all input image and
988
 
989
  Users are responsible for model inputs and outputs. Users are responsible for ensuring safe integration of this model, including implementing guardrails as well as other safety mechanisms, prior to deployment.
990
 
991
- For more detailed information on ethical considerations for this model, please see the Model Card++ [Explainability](EXPLAINABILITY.md), [Bias](BIAS.md), [Safety & Security](SAFETY.md), and [Privacy](PRIVACY.md) subcards. Please report model quality, risk, security vulnerabilities or NVIDIA AI Concerns [here](https://www.nvidia.com/en-us/support/submit-security-vulnerability/).
 
1
  ---
2
  license: other
3
  license_name: openmdw1.1-license
4
+ license_link: https://openmdw.ai/license/1-1/
 
5
  library_name: cosmos
6
  tags:
7
+ - nvidia
8
+ - cosmos
9
+ - cosmos3
10
+ - vllm
11
+ - vllm-omni
12
+ - diffusers
13
+ - text, image, video, audio, and action generation
14
+ - omnimodel
15
+ pipeline_tag: any-to-any
 
16
  ---
17
 
18
  # **Cosmos 3: Omnimodal World Models for Physical AI**
 
34
  - Cosmos3-Nano:
35
  - Given multimodal inputs including text, images, video, audio, and action trajectories, generate coherent text, images, video, audio, and action outputs for multimodal understanding, world simulation, future prediction, action reasoning, and Physical AI applications.
36
 
37
+ - Cosmos3-Super:
38
+ - Given multimodal inputs including text, images, video, audio, and action trajectories, generate coherent text, images, video, audio, and action outputs for multimodal understanding, world simulation, future prediction, action reasoning, and Physical AI applications.
39
+
40
+ - Cosmos3-Nano-Policy-DROID:
41
+ - Given language instructions and visual observations from the DROID robot platform, generate robot action trajectories for manipulation and control tasks.
42
+
43
+ - Cosmos3-Super-Image2Video:
44
+ - Given one input image and text instructions, generate temporally coherent video sequences that are consistent with the provided visual content.
45
+
46
+ - Cosmos3-Super-Text2Image:
47
+ - Given text input, generate high-fidelity images that are consistent with the provided description.
48
+
49
  ### License
50
 
51
  This model is released under the [OpenMDW1.1](https://openmdw.ai/license/1-1/)
 
76
  **Number of trainable model parameters:**
77
 
78
  - Cosmos3-Nano: 16B
79
+ - Cosmos3-Super: 64B
80
+ - Cosmos3-Nano-Policy-DROID: 16B
81
+ - Cosmos3-Super-Image2Video: 64B
82
+ - Cosmos3-Super-Text2Image: 64B
83
 
84
  ## Input/Output Specifications
85
 
 
167
  - [PyTorch](https://github.com/nvidia/cosmos3)
168
  - [vLLM-Omni](https://github.com/vllm-project/vllm-omni)
169
  - [Hugging Face Diffusers](https://huggingface.co/docs/diffusers/en/index)
 
170
 
171
  **Supported Hardware Microarchitecture Compatibility:**
172
 
 
197
 
198
  Training datasets passed through multiple layers of automated and manual safeguards designed to reduce the presence of harmful or policy-violating content across categories including weapons and weapons-related instructional content, criminal planning, child sexual abuse material (CSAM), non-consensual intimate imagery (NCII), sexual content involving minors, harassment, hate speech, profanity, threats and incitement to violence, self-harm or suicide-related content, and graphic violence. Data sources are reviewed for licensing compatibility, provenance, and alignment with internal data governance and safety policies before admission into training corpora. Automated filtering pipelines combine multiple detection strategies: hash-matching against known CSAM and NCII reference databases; classifier-based moderation models trained for explicit sexual content, hate speech, violence, weapons imagery, and other restricted categories; keyword and regex-based screening for criminal-planning, threats, and self-harm phrases in text data; metadata and provenance heuristics for source-level risk signals; and embedding-based anomaly detection to surface samples that fall outside expected distributions. Human review and targeted audits supplement automated filtering for selected datasets, benchmark construction, and safety-sensitive evaluation. For multimodal Physical AI data (robotics, autonomous driving, industrial scenes), additional filtering targets invalid action trajectories, physically implausible interactions, and unsafe control sequences. Synthetic and simulation-generated data are evaluated through internal validation before inclusion. Benchmark evaluations and red-team testing are applied post-training to surface remaining safety gaps across world generation, reasoning, audio, and action tasks. No large-scale data-filtering process can guarantee complete removal of all harmful content; residual risks may remain, particularly in rare edge cases or open-world deployment settings. Ongoing monitoring and dataset review continue post-release.
199
 
 
 
200
  **Data Modality and Training Data Size**
201
 
202
  | Modality | Reasoning Data Sample Count | Generation Data Sample Count |
 
916
 
917
  <video controls width="1280" height="720" src="https://huggingface.co/nvidia/Cosmos3-Nano/resolve/main/assets/example_t2v_diffusers_output.mp4"></video>
918
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
919
  ## Limitations
920
 
921
  Cosmos3 may produce imperfect outputs in challenging scenarios. Generation artifacts include temporal inconsistency, unstable camera or object motion, imprecise physical interactions, inaccurate audio-video synchronization, and action-state drift — especially in long-horizon or high-resolution outputs. Reasoning may also be incorrect: object states, causal relationships, spatial geometry, temporal ordering, agent intent, and future outcomes can be misinferred, and complex or long-context inputs may yield hallucinated entities, inconsistent interpretations, or implausible predictions. Because the model lacks an explicit physics simulator, 3D geometry, 4D space-time evolution, object permanence, contact dynamics, and physical laws are only approximated — producing artifacts such as disappearing or morphing objects, unrealistic collisions, and physically implausible motions. Quality further degrades in out-of-distribution environments, safety-critical edge cases, and domains underrepresented in training.
 
924
 
925
  ## Inference
926
 
927
+ **Acceleration Engine:** [PyTorch](https://pytorch.org/), [vLLM](https://github.com/vllm-project/vllm), [vLLM-Omni](https://github.com/vllm-project/vllm-omni), [Hugging Face Diffusers](https://github.com/huggingface/diffusers)
928
 
929
  **Test Hardware:** GB200 and H100
930
 
 
936
 
937
  Users are responsible for model inputs and outputs. Users are responsible for ensuring safe integration of this model, including implementing guardrails as well as other safety mechanisms, prior to deployment.
938
 
939
+ For more detailed information on ethical considerations for this model, please see the Model Card++ [Explainability](EXPLAINABILITY.md), [Bias](BIAS.md), [Safety & Security](SAFETY.md), and [Privacy](PRIVACY.md) subcards. Please report model quality, risk, security vulnerabilities or NVIDIA AI Concerns [here](https://www.nvidia.com/en-us/support/submit-security-vulnerability/).
modular_model_index.json DELETED
@@ -1,75 +0,0 @@
1
- {
2
- "_blocks_class_name": "Cosmos3OmniBlocks",
3
- "_class_name": "Cosmos3OmniModularPipeline",
4
- "_diffusers_version": "0.39.0.dev0",
5
- "text_tokenizer": [
6
- "transformers",
7
- "Qwen2TokenizerFast",
8
- {
9
- "pretrained_model_name_or_path": "nvidia/Cosmos3-Nano",
10
- "revision": null,
11
- "subfolder": "text_tokenizer",
12
- "type_hint": [
13
- "transformers",
14
- "Qwen2TokenizerFast"
15
- ],
16
- "variant": null
17
- }
18
- ],
19
- "vae": [
20
- "diffusers",
21
- "AutoencoderKLWan",
22
- {
23
- "pretrained_model_name_or_path": "nvidia/Cosmos3-Nano",
24
- "revision": null,
25
- "subfolder": "vae",
26
- "type_hint": [
27
- "diffusers",
28
- "AutoencoderKLWan"
29
- ],
30
- "variant": null
31
- }
32
- ],
33
- "transformer": [
34
- "diffusers",
35
- "Cosmos3OmniTransformer",
36
- {
37
- "pretrained_model_name_or_path": "nvidia/Cosmos3-Nano",
38
- "revision": null,
39
- "subfolder": "transformer",
40
- "type_hint": [
41
- "diffusers",
42
- "Cosmos3OmniTransformer"
43
- ],
44
- "variant": null
45
- }
46
- ],
47
- "scheduler": [
48
- "diffusers",
49
- "UniPCMultistepScheduler",
50
- {
51
- "pretrained_model_name_or_path": "nvidia/Cosmos3-Nano",
52
- "revision": null,
53
- "subfolder": "scheduler",
54
- "type_hint": [
55
- "diffusers",
56
- "UniPCMultistepScheduler"
57
- ],
58
- "variant": null
59
- }
60
- ],
61
- "sound_tokenizer": [
62
- "diffusers",
63
- "Cosmos3AVAEAudioTokenizer",
64
- {
65
- "pretrained_model_name_or_path": "nvidia/Cosmos3-Nano",
66
- "revision": null,
67
- "subfolder": "sound_tokenizer",
68
- "type_hint": [
69
- "diffusers",
70
- "Cosmos3AVAEAudioTokenizer"
71
- ],
72
- "variant": null
73
- }
74
- ]
75
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
sound_tokenizer/diffusion_pytorch_model.safetensors CHANGED
@@ -1,3 +1,3 @@
1
  version https://git-lfs.github.com/spec/v1
2
- oid sha256:a4b6da5975bf89f6853fe589ad4752d281ac79fbdfad52ea90537fa080b4b9c2
3
- size 1985176840
 
1
  version https://git-lfs.github.com/spec/v1
2
+ oid sha256:9d4c61cde38acfb0cad9048a140c3533750277a8462b19dc08450d9fe1ad9879
3
+ size 1892409600