Create an Application

Learn how to create a Clarifai application

---

As mentioned previously, apps on the Clarifai platform act as a central repository for models, datasets, inputs, and other resources.

Create an App on the Portal

To create an app, log in to your account and click the Create button at the upper-right section of the navigation bar.

And on the window that pops up, select the Start with a Blank App option to create a new application from scratch.

tip

You can also select the Use an App Template option to use a template to create a new application.

Next, on the window that appears, provide the information required to create a new application.

• App ID — This serves as a unique identifier for your application. It’s important to choose a unique and memorable ID as it will be used for URLs and redirections.

• Short Description — Optionally, provide a brief description that outlines the purpose or features of your app.

• Primary Input Type — Select the primary type of inputs that will be available in your app: either images/videos or texts/documents.

• Advanced Settings — This collapsible field allows you to choose the base workflow for your app. Base workflows index your data and furnish your app with a default knowledge base. While a base workflow is automatically selected based on your primary input type, you can choose another one that best suits your specific use case.

ID Validation

Application names and other names in the Portal must follow a few rules:

• Names must be 1 to 32 letters or numbers in length, with hyphens or underscores as separators.
• Spaces, periods, etc., are not allowed as separators.

Lastly, click the Create App button at the upper-right corner of the page.

Copy (Duplicate) Apps

You can also create an app by cloning an existing application. Cloning an existing application can be a great way to start a new project, or branch an existing one. We’ve made cloning easy with a simple interface in the Portal.

After logging in to your Clarifai account, select the My Apps option on the navigation bar. Then, select the Apps / Templates option on the menu bar, and a list of your apps will populate that page.

Click the series of dots at the bottom-right corner of the app you want to copy its contents. Then, select the Duplicate option on the list that drops down.

The small window that pops up lets you select the destination user or organization, along with the destination app. You can copy the app as a new one or select an existing app. Additionally, you can specify particular resources you wish to duplicate.

Lastly, click the Confirm button, and the copied app will be automatically created for you.

Create Apps Programmatically

For enterprise customers, it is also possible to generate applications programmatically.

If you are managing the work of multiple users, who's data, models, and concepts that need to be segregated, we recommend you create apps this way. This ensures that each individual user only has access to their own private resources.

tip

You need to use a Personal Access Token (PAT) to create an application.

cURL

curl --location --request POST "https://api.clarifai.com/v2/users/YOUR_USER_ID_HERE/apps/" \
--header "Content-Type: application/json" \
--header "Authorization: Key YOUR_PAT_HERE" \
--data-raw '{
    "apps": [
        {
            "id": "test-application"
        }
    ]
}'