> For the complete documentation index, see [llms.txt](https://paperspace.gitbook.io/gradient/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://paperspace.gitbook.io/gradient/master/projects/managing-projects.md).

# Managing Projects

## Create a Standalone Project

{% tabs %}
{% tab title="Web UI" %}
On the [Projects page](https://console.paperspace.com/projects), click *Create Project* and select *Create Standalone Project*.

![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-LxsdzBprt1Y3DUGCnGW%2F-Lxse1DKuxWj2AlP-xOJ%2Fimage.png?alt=media\&token=f43f6eea-e405-4cd6-b6c3-3170a4f3b802)

Provide a name and then click *Create Project*.

![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-LxxifqfEwQ2lW7rN3MD%2F-LxxjABnHHaVVpUSbKEe%2Fimage.png?alt=media\&token=eb14bcee-b1c1-4d19-b894-4e7f51661ee4)
{% endtab %}

{% tab title="CLI" %}
The following command creates a Project called `ExampleProject`&#x20;

```
gradient projects create --name ExampleProject [OPTIONS]
```

#### Parameters:&#x20;

| Option             | Description                     |
| ------------------ | ------------------------------- |
| `--name`           | Name of new project \[required] |
| `--repositoryName` | Name of the repository          |
| `--repositoryUrl`  | URL to the repository           |
| `--apiKey`         | Key to use this time only       |
| `--help`           | Help for this feature           |
| {% endtab %}       |                                 |
| {% endtabs %}      |                                 |

## Create a GradientCI Project

{% tabs %}
{% tab title="Web UI" %}
[GradientCI](/gradient/master/projects/gradientci-v2.md) Projects allow you to connect a GitHub repository to your Project in order to automatically run experiments when you push new commits or open pull requests (PRs).

Visit <https://console.paperspace.com/projects>, click *Create Project*, and select **Create GradientCI Project**. Make sure you have installed **GradientCI** on the target repository to which you'll link your Project.

![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-LgARQBdPcCz-W8F2y_7%2F-LgARSzlnaSOoLKYRCwS%2FScreen%20Shot%202019-05-30%20at%209.11.47%20PM.png?alt=media\&token=847404cd-40a4-45b2-8d4e-1034ac49779d)

If you haven't yet connected your GitHub account, follow the prompts to grant access to your GitHub repositories and to your GradientCI App installation:

![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-Lg-0mha2NI4wzmHtyDb%2F-Lg-0otu-GR4c-oHMlBc%2FScreen%20Shot%202019-05-28%20at%203.59.49%20PM.png?alt=media\&token=dd2d9e94-d64e-492a-871e-7e79973a34d6)

Then, select the GitHub repo from the dropdown list:

![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-LeTTHpvgFEAFkXRaKCQ%2F-LeTVb7JcGwXSVH7uZ-P%2Fimage.png?alt=media\&token=db4ed843-d909-4b4b-9552-cd8c18c0afa3)
{% endtab %}

{% tab title="CLI" %}
[GradientCI](/gradient/master/projects/gradientci-v2.md) Projects allow you to connect a GitHub repository to your Project in order to automatically run experiments when you push new commits or open pull requests (PRs).

Make sure you have installed **GradientCI** on the target repository to which you'll link your Project.

{% hint style="info" %}
The following command creates a Project called `ExampleProject`&#x20;
{% endhint %}

```bash
gradient projects create --name ExampleProject --repositoryName <name> --repositoryUrl <url>
```

#### Parameters:&#x20;

| Option             | Description                     |
| ------------------ | ------------------------------- |
| `--name`           | Name of new project \[required] |
| `--repositoryName` | Name of the repository          |
| `--repositoryUrl`  | URL to the repository           |
| `--apiKey`         | Key to use this time only       |
| `--help`           | Help for this feature           |
| {% endtab %}       |                                 |
| {% endtabs %}      |                                 |

## Get Your Project's ID

A Project's ID is a required parameter for several commands within Gradient.

{% tabs %}
{% tab title="Web UI" %}
To find the ID, click any Project in the Projects List to navigate to its Project Details page, and then click the Project ID to copy the value to your clipboard:

![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-Lh1SfjqTdrpjcb5CnKZ%2F-Lh1Uh0bxavup0mE8WgA%2Fproject-id.gif?alt=media\&token=e654a544-4235-4f2b-a4d4-db5f8a0dc7c5)
{% endtab %}

{% tab title="CLI" %}
To get a Project ID, you can use the following command:

```bash
gradient projects list
```

{% endtab %}
{% endtabs %}

## Managing access to a Project

To add other team members to a project, click any Project in the projects list to navigate to its Project details page and then click the Accessors tab:

![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-MDv6BqnY3OcKOr3ir1g%2F-MDv7bebI_iDU335qmOm%2Faccessors.png?alt=media\&token=58977c3f-b1c4-4b5c-a1a0-84a670705526)

On the Accessors tab you will find a list of users who already have access to the Project. Add an Accessor by clicking the "Add Accessor" button on the right side of the page. Assign other team members to the Project by selecting their name in the drop-down and clicking on "Assign User":

![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-MDv6BqnY3OcKOr3ir1g%2F-MDv8sRItrDF6xFc08se%2Fassign-user8.png?alt=media\&token=9acab869-05bd-48da-922d-1fab517aec65)

You can also remove members' access to a Project by clicking the "Remove Access" button next to the member's name.

{% hint style="info" %}
Note: Only existing team members will be displayed in the drop-down list. Only Team admins can add additional team members to this list.

Additionally, project access can only be controlled through the web console – Accessors cannot be added or removed through the Gradient CLI.
{% endhint %}

## Deleting a Project

{% tabs %}
{% tab title="Web UI" %}
You can delete a project by visiting the project's `Settings` page and hitting the `Delete Project` button. &#x20;

![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-LuE-KKDw7ozUw6NGwDW%2F-LuE0YLSoIFXY6eGgo4x%2FProject-Settings.jpg?alt=media\&token=2fd0f714-1262-46e7-9efc-b3fd74074b93)

![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-LuE-KKDw7ozUw6NGwDW%2F-LuE0a--wjmLblFqxS0x%2FDeleteProject.jpg?alt=media\&token=6a5023f0-d3a1-4f8f-b69a-653a981cd508)
{% endtab %}

{% tab title="CLI" %}
To delete a Project, you can use the following command:

```bash
gradient projects delete --id <project id>
```

{% endtab %}
{% endtabs %}
