> For the complete documentation index, see [llms.txt](https://docs.jasperapp.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.jasperapp.io/quick-start/setup.md).

# Setup

## Install <a href="#install" id="install"></a>

Download the latest version of Jasper from [jasperapp.io](https://jasperapp.io/) and extract the zip file. Follow the instructions to complete the launch.

{% tabs %}
{% tab title="Mac" %}
![](/files/-MIDM2oKIeaitLwfRtB8)
{% endtab %}

{% tab title="Windows" %}
![](/files/-MIDLW0oADJtewDosv-k)

![](/files/-MIDLZG15mfCgcGJkby0)
{% endtab %}
{% endtabs %}

## Setting up an access token <a href="#access-token" id="access-token"></a>

When Jasper is launched, you will be presented with a choice of GitHub or GHE (GitHub Enterprise), for GHE enter the hostname `example ghe.example.com`.

Next, you will need to enter an access token, which differs between GitHub and GHE.

{% tabs %}
{% tab title="For GitHub" %}
For GitHub, we recommend setting up an access token using OAuth. Please follow the on-screen instructions to perform OAuth authentication.

![](/files/dirM1RVPjppwihWPB4aN)

Alternatively, an access token can be created and used from a [Personal access token](https://github.com/settings/tokens). The required scopes are `repo`, `read:org`, `notifications`, `user` and `read:project` .

![](/files/51IJqR0cYk6NFVk0dasO)
{% endtab %}

{% tab title="For GHE" %}
For GHE, you can create an access token from `https://GHE_HOST/settings/tokens`. The required scopes are `repo`, `read:org`, `notifications`, `user` and `read:project` .

![](/files/WjkxCDglS4ZIOX7bJkNL)
{% endtab %}
{% endtabs %}

Finally, confirm the settings and press OK. When the user name is displayed, you are done 🎉.

![](/files/6uKyAgPX4Rki2tSSAUBI)

## Initial loading <a href="#initial-loading" id="initial-loading"></a>

Once the setup is complete, the system will automatically start loading the issue. This initial loading takes a few minutes or so - do not exit Jasper and use it.

To help you get started with Jasper, please read the "[Basic Usage](/quick-start/basic-usage.md)" section during the initial loading process.
