Working with Projects

Projects allow users to organize work and share their development with others. You can direct jobs, models, and other assets to a project, creating a dedicated space to track all work toward a shared goal. Each project has customizable permissions settings to make it easy to manage access with teammates and collaborators.

Submitting to a Project

By default, every user has a personal project created for them and any jobs submitted without a project defined will be directed to the user’s personal project. Associating your job with any other project requires specifying the project field upon submission.

To create a project, click the Projects tab from the AI Hub Workbench navigation bar and use the blue Create Project button. Once the project is created, navigate to the project page and check the URL to see the full project name; if the URL of the project page is aihub.qualcomm.com/projects/my-project-tlielcn1zo, the full project name is my-project-tlielcn1zo.

Projects can be set in two ways: by setting the default project when instantiating the client or upon job submission.

To set the default project, set default_project_id="project-name" when instantiating the Client():

import qai_hub as hub

client = hub.Client(default_project_id="my-project-tlielcn1zo")

To specify a project on submission, set the project="project-name" field, like so:

import qai_hub as hub

compile_job = hub.submit_compile_job(
    model="mobilenet_v2.pt",
    device=hub.Device("Samsung Galaxy S23 (Family)"),
    project="my-project-tlielcn1zo",
)

While the example above is for a compile job, the same option is available for other types of jobs.

Note

Moving and copying assets between projects is not currently supported.

Managing Project Access

Project access can be granted to both individual users or teams of users. To edit permissions, navigate to your project through the UI and click on the Settings button in the top-right. In the Settings/Members section, users and teams can be added with the following roles:

  • Guest (view access)

  • Collaborator (view and edit access)

  • Maintainer (view, edit, admin access)

Teams can also be created and edited through the UI. Choose the Teams tab from the AI Hub Workbench navigation bar to create and manage teams of users.