Create Catalog

This page shows you how to create a new, empty Catalog.

This is the first step that is required before you are able to upload and process your files with 💾 Instill Artifact into a unified AI-ready format.

#Create Catalog via API

cURL

Python

export INSTILL_API_TOKEN=********
curl -X POST 'http://localhost:8080/v1alpha/namespaces/NAMESPACE_ID/catalogs' \
--header "Content-Type: application/json" \
--header "Authorization: Bearer $INSTILL_API_TOKEN" \
--data '{
  "name": "Your Catalog Name",
  "description": "A brief description of your Catalog"
}'

Note that the NAMESPACE_ID path parameter must be replaced by the Catalog owner's ID (namespace). The new name should be lowercase, without any space or special character except for hyphens. It cannot start with a number or hyphen, and should be less than 32 characters.

#Create Catalog via 📺 Instill Console

To create a new Catalog from 📺 Instill Console, follow these steps:

Launch 📺 Instill Console via a local 🔮 Instill Core deployment at http://localhost:3000.
Navigate to the Artifacts page using the navigation bar.
Click the + Create Catalog button.
Select the Owner (namespace).
Enter the name for your Catalog.
(Optional) Enter the description and tags for your Catalog.
Click the Create button.