Skip to main content
Version: 26.1

Projects

Projects in Co-Scientist group the pipelines, datasets, and workflow runs that belong to a single piece of work. View and chat about them without the noise of the rest of the workspace.

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

note

Projects are part of the Co-Scientist web interface. The portal must be deployed alongside Co-Scientist in your Enterprise installation. See Install Co-Scientist for more information.

How projects are derived​

When you open a workspace in the Co-Scientist web interface:

  1. Co-Scientist 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​

To 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 Co-Scientist. 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 Co-Scientist needs to auto-attach the label when you upload new datasets into the project.

Display names​

Co-Scientist strips the project_ prefix to produce the display name shown in the web interface:

Platform labelCo-Scientist display name
project_rnaseqProject rnaseq
project_wgsProject wgs
project_single_cellProject 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.

For problems with project labels and empty states, see Co-Scientist troubleshooting.

Learn more​

On this Page