# Setting up

## Step 1: Create an account <a href="#create-account" id="create-account"></a>

1. Go to [play.instruqt.com/signup](https://play.instruqt.com/signup) and create an account.
2. Have your colleagues add you to your company's Instruqt team.

## Step 2: Explore the Web UI <a href="#explore-web-ui" id="explore-web-ui"></a>

For new users, we recommend getting started using our Web UI.

1. Go to [play.instruqt.com](https://play.instruqt.com)
2. Explore the content from your company's Instruqt team

## Step 3: Install the Instruqt CLI (optional)  <a href="#install-cli" id="install-cli"></a>

For advanced, code-first workflows, you can install the Instruqt CLI. The CLI is available on macOS, Windows and Linux, and can be installed using the following methods.

### Using a package manager

{% tabs %}
{% tab title="macOS (homebrew)" %}

1. Open a terminal
2. Install the CLI using [Homebrew](https://brew.sh)

   <pre><code><strong>brew install instruqt/tap/instruqt
   </strong></code></pre>
3. Confirm the Instruqt CLI was installed correctly:

   <pre><code><strong>instruqt
   </strong></code></pre>

{% endtab %}

{% tab title="Windows (winget)" %}

1. Open a PowerShell window
2. Install the CLI using [WinGet](https://learn.microsoft.com/en-us/windows/package-manager/winget/):

   <pre><code><strong>winget install instruqt
   </strong></code></pre>
3. Close and re-open the PowerShell window
4. Confirm the Instruqt CLI was installed correctly:

   <pre><code><strong>instruqt
   </strong></code></pre>

{% endtab %}
{% endtabs %}

### Manually from the latest release

Instruqt CLI releases are published to GitHub. You can download the latest release for your Operating System from <https://github.com/instruqt/cli/releases/latest>. Refer to the instructions below how to install these for your system.

{% tabs %}
{% tab title="macOS" %}

1. Open a terminal.
2. Download the appropriate CLI **(Apple Silicon or Intel Macbook, in that order):**

   ```bash
   curl -L https://github.com/instruqt/cli/releases/latest/download/instruqt-darwin-arm64.zip -o instruqt.zip
   ```

   ```bash
   curl -L https://github.com/instruqt/cli/releases/latest/download/instruqt-darwin-amd64.zip -o instruqt.zip
   ```
3. Extract the CLI binary:

   ```bash
   unzip instruqt.zip
   ```
4. Copy the binary to your local `bin` directory:

   ```bash
   sudo cp instruqt /usr/local/bin
   ```
5. Make the binary executable:

   ```bash
   sudo chmod +x /usr/local/bin/instruqt
   ```
6. Confirm the Instruqt CLI was installed correctly:

   ```
   instruqt
   ```

{% hint style="info" %}
**Need help?**\
Here's a [video tutorial](https://www.youtube.com/watch?v=6N1c5kMU4P4) to guide you through the installation process.
{% endhint %}
{% endtab %}

{% tab title="Windows" %}

1. Open a PowerShell window.
2. Copy and paste the following code:

   ```powershell
   mkdir scripts
   cd scripts
   [Environment]::SetEnvironmentVariable("Path", $env:Path + ";$($pwd.Path)", "User")
   Invoke-WebRequest -Uri https://github.com/instruqt/cli/releases/latest/download/instruqt-windows.zip -OutFile "instruqt.zip"
   Expand-Archive instruqt.zip -d .
   rm instruqt.zip
   ```
3. Close and re-open your Powershell window to detect the new program.
4. Enter the following command to check if Instruqt CLI was installed correctly:

   ```
   instruqt
   ```

{% hint style="info" %}
**Need help?**\
Here's a [video tutorial](https://www.youtube.com/watch?v=i4WH5WU_20w) to guide you through the installation process.
{% endhint %}
{% endtab %}

{% tab title="Linux" %}

1. Open a terminal.
2. Download the CLI:

   ```bash
   curl -L https://github.com/instruqt/cli/releases/latest/download/instruqt-linux.zip -o instruqt.zip
   ```
3. Extract the CLI binary:

   ```bash
   unzip instruqt.zip
   ```
4. Copy the binary to your local `bin` directory:

   ```bash
   sudo cp instruqt /usr/local/bin
   ```
5. Make the binary executable:

   ```bash
   sudo chmod +x /usr/local/bin/instruqt
   ```
6. Confirm the Instruqt CLI was installed correctly:

   ```bash
   instruqt
   ```

{% hint style="info" %}
**Need help?**\
Here's a [video tutorial](https://www.youtube.com/watch?v=i4WH5WU_20w) to guide you through the installation process.
{% endhint %}

{% endtab %}
{% endtabs %}

{% hint style="info" %}
The Instruqt CLI collects basic usage information and sends crash reports by default. No personal information is collected. You can disable these behaviours [by following this guide](/reference/cli/commands.md#telemetry-and-crash-reports).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.instruqt.com/getting-started/set-up-instruqt.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.