Projects

Projects in Seqera AI group the pipelines, datasets, and workflow runs that belong to a single piece of work, so you can view and chat about them without the noise of the rest of the workspace.

Projects are not created inside Seqera AI. They are derived from workspace labels in Seqera Platform whose names start with project_. Each matching label surfaces in Seqera AI as a separate project scope, with the Platform label acting as the source of truth for membership.

How projects are derived

When you open a workspace in the Seqera AI web interface:

1. Seqera AI reads the list of workspace labels from the Seqera Platform API.
2. Any label whose name starts with project_ becomes a project.
3. An Entire workspace view is always included alongside your projects so you can see every resource in the workspace.
4. Pipelines, datasets, and workflow runs are scoped to a project by matching on its project_* label.

Because membership lives on the Platform label, adding or removing a resource from a project is the same action as applying or removing the label in Platform.

Create a project

1. In Seqera Platform, open the workspace where the project should live.
2. Go to Labels in workspace settings and create a new label with the project_ prefix. For example:
   • project_rnaseq
   • project_variant_calling
   • project_chip_seq
3. Apply the label to the pipelines and datasets that belong to the project.
4. Open Seqera AI. The new project appears on the Projects page and in the chat project selector on the next page load.

tip

Create the label in workspace settings before applying it to resources. This ensures the label has a Platform-assigned ID, which Seqera AI needs to auto-attach the label when you upload new datasets into the project.

Display names

Seqera AI strips the project_ prefix to produce the display name shown in the web interface:

Platform label	Seqera AI display name
project_rnaseq	Project rnaseq
project_wgs	Project wgs
project_single_cell	Project single_cell

Choose descriptive names after the prefix so projects are easy to identify.

Where projects appear

Once a project_* label exists in the workspace and is applied to at least one resource, the project is used in the following places:

• Projects page: one row per project, plus the Entire workspace row.
• Project details page: the pipelines, datasets, and workflow runs filtered to that project's label.
• Chat project selector: scopes the resources the AI can see and act on during a chat session.
• Dataset upload: when you upload a dataset from inside a project, the project's label is auto-attached.

Edge cases

A resource carries a project_* label that isn't in the workspace label list

If a pipeline has a project_* label but the label has not been created in workspace settings, Seqera AI still surfaces the project, inferred from the pipeline. In this case:

• The project has no Platform-assigned label ID.
• Dataset uploads into the project cannot auto-attach the label.

To avoid this, always create project_* labels in workspace settings first, then apply them.

No project_* labels in the workspace

When a workspace has no project_* labels:

• The Projects page shows a No projects configured yet empty state.
• The project selector is hidden in the chat header.
• The workspace view shows a header-only empty state.

Ask a workspace admin to create the first project_* label to enable projects for the workspace.

Learn more

• Seqera Platform labels: Create and manage workspace labels
• Get started with Seqera AI: Install and authenticate Seqera AI