Edit on GitHub

Create a Project

In this section, you will learn how to:

Connect to a Git repository and add a project

To add a new project, follow these steps.

  1. Sign in to your Iterative Studio dashboard using your GitHub.com, GitLab.com, or Bitbucket.org account, or with your email address.

  2. Click on Add a Project. All the organizations that you have access to will be listed.

If you do not see your desired organizations or Git repositories, make sure that the connection to your Git server has been set up.

To connect to your GitHub repositories, you must install the Iterative Studio GitHub app. Refer to the section on GitHub app installation for more details.

To connect to repositories on your self-hosted GitLab server, you must first add a connection to this server and create a team. Refer to the section on self-hosted GitLab server support for more details.

  1. Open the organization whose repository you want to connect to. You can also use the search bar to directly look for a repository.

  2. Specify additional connection settings if required.

Project settings must be configured if you are connecting to a non-DVC repository, if your metrics are in some custom files, if you are connecting to a monorepo, or if your metrics are in cloud or other remote storage. However, you can configure the project settings after the project has been created. So, you can Skip and Continue now. Refer to the Project Settings section for more details.

You should now see that a project has been added in your dashboard.

  1. If your project requires any of the additional settings, then remember to configure them by opening the project settings. Otherwise, your project may not work as expected. To go to project settings, click on the icon in the project. In the menu that opens up, click on Settings.

Create multiple projects from a single Git repository

You can also create multiple projects in Iterative Studio from a single Git repository and apply different settings to them.

One use case for this is if you have a monorepo with multiple ML projects, each one in a different sub-directory.

For each ML project in the monorepo, follow the above process to connect to the Git repository. Then go to the project settings, and specify the sub-directory in which the desired ML project resides.

This way, you will have multiple Iterative Studio projects for your single Git repository, with each project presenting values from a different sub-directory.

Create projects shared across a team

You can create teams with one or more team members, also called collaborators.

Each team will have its own projects dashboard, and the projects that you create in the team's dashboard will be accessible to all members of the team.

To add more than 2 collaborators in your team, you can upgrade to the Basic or Enterprise plan.