DocsProjects
RegistryArtifacts VersioningProjects

Overview

A Project is an abstraction that defines one or multiple artifacts created in Polyaxon or other system, it can:

  • have multiple versions.
  • be published publicly or privately within your organization.
  • define team and project level permissions.

Project creation

You can version your artifacts in each project or create a project to manage artifacts from multiple projects using the CLI, API, or the UI.

In acme > Add > New project, turn on Enable versioning and select artifact. For a project dedicated to artifact versions, turn off Enable runtimes and leave the other version types unchecked.

Create a project with only artifact versioning enabled

Alternatively you can create a project using the CLI:

polyaxon project create --name OWNER_NAME/MODEL_NAME --description ... --tags tag1,tag2,...

For an existing project, open Settings > Features, keep Enable features on, and select artifact. Turn off Enable runtimes if the project only stores versions, then click Save. The dedicated acme/artifact-store project uses this configuration.

Artifact-store features with runtimes disabled and only artifact versioning enabled

Project overview

You can view a project that manages the artifacts' versions using the project CLI or UI.

CLI

polyaxon project get -p OWNER_NAME/MODEL_NAME

UI

This example uses acme/artifact-store, which stores versioned datasets with runtimes disabled.

Artifact-store overview with four dataset releases

Artifacts versions

CLI

polyaxon artifacts ls -p OWNER_NAME/MODEL_NAME --query ... --sort ...

UI

artifacts-versions

Project admin

CLI

Updating

polyaxon project update -p ...

Deleting

polyaxon project delete -p ...

UI

You can manage a project using the UI, you can also manage who can contribute and have access to the artifacts versions, as well as from which projects users are allowed to promote runs

artifacts-admin