Workspace Models

Read this page to learn about how to navigate and create model zoos in the DeGirum AI Hub. All users have access to the model zoo. The ability to create model zoos is on a per-workspace basis.

If your Workspace has permission, you can create Workspace Model Zoos for your Workspace.

Creating a Workspace Model Zoo

If your Workspace has permission to create Model Zoos:

1

Click Models in the navigation bar on the left

You will see tiles for Model Zoos and All Models. Click the Model Zoos tile.

Model Zoos and All Models Tiles
2

Click New Model Zoo

After you click the Model Zoos tile, you will be brought to the list of model zoos.

New Model Zoo button when viewing Model Zoos

If enabled for your Workspace, there will be a New Model Zoo button. Click the New Model Zoo button.

3

Set up the Model Zoo

After you click the New Model Zoo button, a window opens with a menu to set up the model zoo.

New Model Zoo form
  • Model Zoo Name: Name of the model zoo.

  • Model Zoo Description: Description of the model zoo.

4

Click Add New Model Zoo

The Model Zoo will be created for your Workspace.

Viewing all models in your Workspace

You can easily view all models available in your Workspace.

Model Zoos and All Models Tiles

To view all models:

1

Click Workspace Models in the navigation bar on the left

You will see tiles for Model Zoos and All Models.

2

Click All Models

After clicking the All Models tile, you will see a directory of models. You will also see a search/filter panel to search and filter models.

To view all models in a Workspace:

1

Select a Workspace in the navigation bar on the left

The Workspace you have selected will determine what models you can view.

2

Click Workspace Models

You will see tiles for Model Zoos and All Models.

3

Click All Models

After clicking the All Models tile, you will see a directory of models. You will also see a search/filter panel to search and filter models. This directory of models features only models in the Workspace you selected; it will not feature any models available in the public Model Zoo. Likewise, the search/filter panel will filter only models in the Workspace.

Models Directory Page

The Models Directory page displays information about models and provides a few action buttons.

Models Directory Page
  • Name: Identifies each model. We provide a recommended naming convention for models in our documentation about organizing models for DeGirum PySDK.

    • If you are viewing all models, the Models Directory Page will also indicate the workspace and zoo where the model lives.

  • Devices: Hardware compatibility of the model. This information is retrieved from the model JSON file.

  • Version: Version number of each model. This information is retrieved from the model JSON file.

  • Action Buttons:

    • Edit: Opens a window to edit the model readme, model JSON file, and labels JSON file. You will need the right permissions to use this action button.

    • Download: Downloads a zip file containing the model, model JSON file, and labels JSON file.

    • Copy: Copies the model to a different model zoo controlled by your workspace. You will need the right permissions to use this action button.

    • Delete: Deletes the model from the model zoo. You will need the right permissions to use this action button.

If you are viewing a specific model zoo, the models page features:

  • Model Zoo Action Buttons: Buttons to copy the Model Zoo AI Hub path, edit the Model Zoo, and delete the Model Zoo. The edit and delete action buttons are identical to the edit and delete action buttons available in the Model Zoos page. You will need the right permissions to use this action button.

  • New Model button: Allows you to upload a new model if your workspace created the Model Zoo. To upload a model, you must prepare a zip file containing the model, model JSON, and labels JSON all in one archive. The max size of this zip file is 1 GB. The Models Directory page will automatically identify information about the model based on the contents of the JSON file in the uploaded archive.

  • Pagination Controls: Navigates through pages of models.

Search/Filter Panel When Viewing the Models Directory Page

When viewing the Models Directory page, the search/filter panel enables searching by model name and filtering by device type, quantization, and output postprocessor type.

Search/Filter Panel for the Models Directory Page

Click Quick Search and enter text to search the model list for model names matching your search.

Click buttons for Device Type, Quantization, and Output Postprocessor Type to filter models.

  • Device Type: Hardware compatibility of the model.

  • Quantization: Whether the model is a floating point model or a quantized model. Quantized models typically perform much faster than floating point models.

  • Output Postprocessor Type: The type of postprocessor file used by the model. Most models use postprocessors, but some models do not require postprocessors.

Viewing Model Zoos

1

Verify that you have your Workspace selected

Your selected Workspace determines which model zoos you can view. Select your Workspace using the Workspace dropdown in the left navigation bar.

2

Click Workspace Models in the Navigation Bar on the Left

You will see tiles for Model Zoos and All Models. Click the Model Zoos tile.

3

View Available Model Zoos

After clicking the Model Zoos tile, you will see tiles for model zoos. You will also see a search/filter panel to search and filter model zoos.

Model Zoos Page

The Model Zoos page displays model zoo tiles and provides a few action buttons.

Model Zoos page

Each model zoo tile follows this format:

  • Model Zoo Name: Identifies each model zoo. Written in bold.

  • Workspace: The workspace that created the model zoo. Written in italics beneath the model zoo name.

  • Action Buttons:

    • Edit: Opens a window to edit the model zoo name and description. You will need the right permissions to use this action button.

    • Visibility: Displays the model zoo's visibility.

    • Delete: Deletes the model zoo. Opens a confirmation pop-up to confirm deletion of the selected model zoo. Deleted model zoos cannot be restored.

Additionally, the Model Zoos page features:

  • Sort Controls: Sort the model zoo tiles by model count or alphabetically in descending order.

  • Pagination Controls: Navigates through pages of model zoo tiles.

Search/Filter Panel When Viewing Model Zoos

When viewing model zoos, the search/filter panel enables searching by model zoo name and filtering by organization and visibility.

Search/Filter Panel for the Model Zoos page

Click Quick Search and enter text to search the model zoos for model zoos matching your search.

Click buttons for organization and visibility to filter models.

  • Organization: The workspace that created the model zoo.

  • Visibility: Indicates whether the model zoo is Private, Shared Private, or Public. All zoos created by workspaces are private. Only DeGirum publishes public model zoos.

Last updated

Was this helpful?