> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://nemo-platform.docs.buildwithfern.com/nemo/platform/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://nemo-platform.docs.buildwithfern.com/nemo/platform/_mcp/server.

# Projects

<a id="entities-projects-overview" />

Projects are optional organizational tags within a workspace. They let you group related resources—such as datasets, customization jobs, and evaluation results—without creating separate access boundaries. Anyone with access to the workspace can see all its projects.

Use projects when you need to organize related work within a team. For example, group everything related to a fine-tuning experiment (`llama-3-customer-support-v2`) or an evaluation campaign (`quarterly-eval-2025q1`). For access isolation between teams or environments, use separate workspaces instead.

## Project vs. Workspace

| Need                             | Solution                   |
| -------------------------------- | -------------------------- |
| Separate teams or users          | Different workspaces       |
| Separate environments (dev/prod) | Different workspaces       |
| Group related work               | Project within a workspace |
| Quick one-off task               | Workspace only, no project |

Think of workspaces as filing cabinets (separate, locked) and projects as labels you can apply to documents within a cabinet.

## Create a Project

To create a project, provide a `name` and optionally a `description`. The `name` must be unique within the workspace.

Resource names must follow these rules:

* Must start with a lowercase letter (`a`-`z`)
* 2-63 characters long
* Allowed characters: lowercase letters, digits, hyphens, and temporarily `@`, `.`, `+`, `_`
* No consecutive hyphens (`--`)
* Cannot end with a hyphen

**Example valid names:** `my-model`, `llama-3.2-3b`, `test-config-v1`

Once created, a project cannot be renamed.

```python
import os
from nemo_platform import NeMoPlatform

client = NeMoPlatform(
    base_url=os.environ.get("NMP_BASE_URL", "http://localhost:8080"),
    workspace="default",
)

project = client.projects.create(
    workspace="ml-team",
    name="llama-finetune-v2",
    description="Fine-tuning experiment for customer support",
)
```

```bash
nemo projects create \
    --workspace ml-team \
    --name llama-finetune-v2 \
    --description "Fine-tuning experiment for customer support"
```

## List Projects

To list projects in a workspace, call the list endpoint. The response includes pagination metadata.

```python
import os
from nemo_platform import NeMoPlatform

client = NeMoPlatform(
    base_url=os.environ.get("NMP_BASE_URL", "http://localhost:8080"),
    workspace="default",
)

response = client.projects.list(workspace="ml-team")
for project in response.data:
    print(f"{project.name}: {project.description}")
```

```bash
nemo projects list --workspace ml-team
```

## Get a Project

To retrieve a specific project by its `name`:

```python
import os
from nemo_platform import NeMoPlatform

client = NeMoPlatform(
    base_url=os.environ.get("NMP_BASE_URL", "http://localhost:8080"),
    workspace="default",
)

project = client.projects.retrieve("llama-finetune-v2", workspace="ml-team")
```

```bash
nemo projects get llama-finetune-v2 --workspace ml-team
```

## Update a Project

To update a project, only the `description` field can be modified. The `name` cannot be changed after creation.

```python
import os
from nemo_platform import NeMoPlatform

client = NeMoPlatform(
    base_url=os.environ.get("NMP_BASE_URL", "http://localhost:8080"),
    workspace="default",
)

project = client.projects.update(
    "llama-finetune-v2",
    workspace="ml-team",
    description="Updated: Fine-tuning experiment for customer support chatbot",
)
```

```bash
nemo projects update llama-finetune-v2 \
    --workspace ml-team \
    --description "Updated: Fine-tuning experiment for customer support chatbot"
```

## Delete a Project

To delete a project:

```python
import os
from nemo_platform import NeMoPlatform

client = NeMoPlatform(
    base_url=os.environ.get("NMP_BASE_URL", "http://localhost:8080"),
    workspace="default",
)

client.projects.delete("llama-finetune-v2", workspace="ml-team")
```

```bash
nemo projects delete llama-finetune-v2 --workspace ml-team
```