Installation

Cosmos 3 supports several integrations, each with its own dependencies and runtime setup. Start with the common setup below, then follow the instructions for your selected integration in the Cosmos 3 Quickstart Guide.

Note

Ensure that you have the required hardware and software described in the prerequisites before installing Cosmos 3.

Common Setup

1. Clone the Cosmos repository and install Git LFS, which is used for large repository assets:

   git clone https://github.com/NVIDIA/cosmos.git
   cd cosmos
   git lfs install
   

2. Install uv, the Python package and environment manager used by the examples:

   curl -LsSf https://astral.sh/uv/install.sh | sh
   source $HOME/.local/bin/env
   

Model Access

Cosmos 3 model repositories on Hugging Face are gated. Request access to the model you plan to use in the NVIDIA Cosmos 3 Hugging Face collection, then create a Hugging Face access token with Read permissions. Authenticate locally before downloading a model:

hf auth login

For NIM integrations, obtain an NGC API key and configure Docker access as described by the selected NIM container; NIM uses NGC_API_KEY rather than Hugging Face authentication.

Next Steps

Use the Cosmos 3 Model Matrix to select a model, then continue to the Cosmos 3 Quickstart Guide for an integration-specific path.