C3 AI Documentation Home

Create an Application in C3 AI Studio

C3 AI applications use a modular architecture to support reuse and maintenance. Each application consists of one or more packages. These packages include Type definitions, implementation files, UI files, configurations, scripts, metadata, seed data, and tests.

Applications run in one of two environments:

  • Single node environment (SNE): A limited-resource environment that is ideal for application development and testing.
  • Shared environment (multi node environment, MNE): A scalable environment that is suitable for staging or for production use.

This document guides you to create a C3 AI application in your C3 AI Studio cluster. To manage an existing application, see Manage Environments and Applications in C3 AI Studio. To learn more about packages, see Package Management Overview.

Prerequisites

Before creating an application, you must have the following:

  1. Access to a C3 AI Studio cluster.
  2. A running environment in your C3 AI Studio cluster.
  3. A StudioUser or StudioAdmin role. For more information about these roles, see C3 AI Studio Built-in Roles.

For guidance on creating an environment, see Create an Environment in C3 AI Studio. If your organization is not yet a C3 AI customer, contact us for more information.

Launch the Start Application modal

Launch the Start Application modal from one of these C3 AI Studio pages:

  • Home: Select Create Application.
  • Envs > environment Overview: Select Create Application.
  • Apps: Select New Application.

The modal guides you through four steps:

  1. Select a package
  2. Configure deployment
  3. Configure compute
  4. Review and create

The available package sources, application modes, and compute options depend on the environment you select. Single node environments support application development and testing; shared environments support staging and production.

Create your application

Step 1: Select a package

  1. Select the target Environment.
  2. Under Source from, select where the application's root package comes from:
    • New Package: Develop your package from scratch. Enter a Package Name (alphanumeric characters only, for example MyPackage) and a Version (semantic version, for example 1.0.0).
    • GitHub Repository: Import packages directly from GitHub. Provide the repository URL, branch, package, and path, then connect with a GitHub access token. For more information, see Version Control with GitHub.
    • Synced Development Packages: Use development packages previously synced to your environment.
    • Built Artifacts: Use pre-built packages with dependencies bundled. To learn more about artifacts, see Register an Artifact to a Cluster.
  3. Under Dependencies, select any package dependencies. Select Add Dependency to add another.
  4. Select Next.

For more information about application packages, see Package Management Overview.

Step 2: Configure deployment

  1. Enter the Application name. The application name can be up to 28 characters, using only lowercase alphanumeric (a-z, 0-9) characters.

    Your application name must be unique within your environment. Do not reuse the name of a deleted application.

  2. Select an Application mode. Single node environments support Development and Trial; shared environments support Production and Test. The mode affects testing and automatic schema migration. Select Expand details to compare modes, or see Application Modes in C3 AI Studio.
  3. Select Next.

Step 3: Configure compute

  1. Select a compute option. You need the StudioAdmin role to customize compute. Contact your C3 AI Studio administrator if you need a custom option but it is unavailable.
  2. Select Next.

Step 4: Review and create

Review your application settings. To edit a previous step, select Back or select the step in the navigation panel. When you are satisfied, select Start Application.

Application states

A C3 AI application can have one of the following states:

  • Starting
  • Running
  • Stopping
  • Stopped
  • Terminating
  • Degraded
  • Error
  • Upgrading

View application states in any of the following pages:

  • Home: Status appears on the application card.
  • Apps: Status appears in the list view.

Terminate an application

You can terminate an application from one of these C3 AI Studio pages:

Home

  1. Hover over the target application card.
  2. Select the Actions ellipsis (...), then select Terminate application.

Apps

  1. Locate the application in the list.
  2. Select the ellipsis menu (...) at the end of the row.
  3. Select Terminate application.

Terminating an application permanently deletes it and releases its resources. For information about temporarily scaling down an environment, see Hibernate Environments and Applications.

See also

Was this page helpful?