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

# Connect to GitHub or GitLab.com

## Overview

**Connecting the GitHub or GitLab integrations enables AI Workbench to create remote repositories.**

This simplifies creating new projects and pushing them to respective platforms and namespaces.

Both platforms allow you to authenticate by OAuth or by PAT.

**You should have an active account on GitHub or GitLab before connecting the integration.**

Create an account on the platform if you don't already have one.

## Connect GitHub Using OAuth

**Step One: Open Settings and navigate to the GitHub integration.**

1. Select **Gear Icon (Top Right) > Settings**
2. Select **Settings > Integrations > GitHub Card > Connect**
3. Select **OAuth**

**Step Two: Complete the GitHub authentication flow.**

1. Click through the prompts to connect to your GitHub account
2. Copy the code displayed in the AI Workbench popup
3. Paste the code into the GitHub authentication page

**Step Three: Authorize the NVIDIA GitHub App.**

1. Select **Authorize** on the GitHub authorization page
2. Wait for the connection to complete

**Success: The GitHub card in Settings shows a connected status.**

<Note>

Learn more about OAuth apps in the [GitHub documentation](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/authorizing-oauth-apps).

</Note>

## Connect GitHub Using PAT

**Step One: Create a Personal Access Token on GitHub.**

1. Go to [GitHub PAT settings](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)

2. Create a new token with the following scopes:

   - `repo` — Full control of private repositories
   - `read:org` — Read access to organization membership and teams
   - `user` — Read access to user profile information
   - `read:packages` — Read access to GitHub packages

3. Copy the generated token

**Step Two: Open Settings and navigate to the GitHub integration.**

1. Select **Gear Icon (Top Right) > Settings**
2. Select **Settings > Integrations > GitHub Card > Connect**
3. Select **Personal Access Token**

**Step Three: Enter your PAT and complete the connection.**

1. Paste your PAT into the token field
2. Select **Connect**

**Success: The GitHub card in Settings shows a connected status.**

## Connect GitLab Using OAuth

**Step One: Open Settings and navigate to the GitLab integration.**

1. Select **Gear Icon (Top Right) > Settings**
2. Select **Settings > Integrations > GitLab Card > Connect**
3. Select **OAuth**

**Step Two: Complete the GitLab authentication flow.**

1. Click through the prompts to connect to your GitLab account
2. Wait for the connection to complete

**Success: The GitLab card in Settings shows a connected status.**

## Connect GitLab Using PAT

**Step One: Create a Personal Access Token on GitLab.**

1. Go to [GitLab PAT settings](https://docs.gitlab.com/user/profile/personal_access_tokens/)
2. Create a new token with the `api` scope
3. Copy the generated token

**Step Two: Open Settings and navigate to the GitLab integration.**

1. Select **Gear Icon (Top Right) > Settings**
2. Select **Settings > Integrations > GitLab Card > Connect**
3. Select **Personal Access Token**

**Step Three: Enter your PAT and complete the connection.**

1. Paste your PAT into the token field
2. Select **Connect**

**Success: The GitLab card in Settings shows a connected status.**

<Note>

Learn more about GitLab Personal Access Tokens in the [GitLab documentation](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html).

</Note>