Chapter 2. Add a model catalog source

Procedure

1. In the OpenShift AI dashboard, click Settings Model resources and operations Model catalog settings.
2. Click Add a source.

3. In the Add a source dialog, configure the following settings:

   • Name: Enter a descriptive name for the catalog source.

   • Source type: Select the type of catalog source:

     • Hugging Face repository: A source from a Hugging Face repository and organization.
     • YAML file: A source defined by a YAML file that contains model metadata.

4. Configure the catalog source based on the selected type:

   • For a Hugging Face repository: In the Allowed organization field, enter the Hugging Face organization name to sync models from, for example, meta-llama or ibm-granite.

     All public models from the specified organization will be available in the catalog.

     Note

     You must enter the organization name used in the Hugging Face URL slug, for example, meta-llama, and not the display name of Meta Llama.

   • For a YAML file: In the Upload a YAML file field, drag and drop or click Upload to select your catalog YAML file. Alternatively, you can paste the contents of the YAML file into the text box.

     The YAML file must contain the model definitions with metadata that includes model name, description, and deployment information.

5. Optional: Configure model visibility settings to control which models are available to users:

   1. Click Model visibility.

   2. To include only specific models, enter one or more patterns in the Include models field.

      For example, Llama* only includes model names that start with Llama.

      Important

      For YAML sources, you must specify the full model name prefix including the organization. For Hugging Face sources, specify only the model name without the organization prefix.

   3. To exclude specific models, enter one or more patterns in the Exclude models field.

      For example, Llama-2* excludes all Llama 2 models, or *DeepSeek* excludes all models that contain DeepSeek in the name.

   4. Click Preview to view the available models based on your visibility settings.

      The preview shows which models are included and which are excluded based on your patterns.

6. Optional: To enable the source in the catalog, select Enable source.

   When the source is disabled, the source is saved but models are not available to users. You can enable the source later after reviewing the configuration.

7. Click Add to create the catalog source.

Verification

1. On the Model catalog settings page, verify that the new catalog source displays in the list.

   If you enabled the source, the validation status is Starting. Wait for the validation status to update to Connected.

2. Click AI hub Catalog.

3. In the menu bar, verify that models from your new catalog source are displayed:

   • If the source has no label, click Other models.
   • If the source has a label, click <your-label-name> models.