> 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

Just download Jasper and set up a GitHub access token and you're ready to go.

## 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" %}
![](https://2402691658-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHdBvXuUTTvADT4CXrm%2F-MIDKu9X0IVqZLtTLI2P%2F-MIDM2oKIeaitLwfRtB8%2F02_mac.png?alt=media\&token=4d24e743-6e8a-4d33-90ee-57916f429e7b)
{% endtab %}

{% tab title="Windows" %}
![](https://2402691658-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHdBvXuUTTvADT4CXrm%2F-MIDKu9X0IVqZLtTLI2P%2F-MIDLW0oADJtewDosv-k%2F02_windows1.png?alt=media\&token=c59c0b98-009e-47c5-ac1c-b78625ad51f9)

![](https://2402691658-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHdBvXuUTTvADT4CXrm%2F-MIDKu9X0IVqZLtTLI2P%2F-MIDLZG15mfCgcGJkby0%2F02_windows2.png?alt=media\&token=7f0c8fc4-b9d1-46f1-a792-cce8cd387e06)
{% 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.

![](https://2402691658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHdBvXuUTTvADT4CXrm-1972196547%2Fuploads%2FTX8FSb7vdSGOePnfsgpp%2FScreen%20Shot%202022-08-16%20at%2016.27.19.png?alt=media\&token=babc48a4-728e-42aa-8e09-31ff0dbe37ee)

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` .

![](https://2402691658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHdBvXuUTTvADT4CXrm-1972196547%2Fuploads%2FylrJC78Bp9YDnALWtMku%2FScreen%20Shot%202022-08-17%20at%2012.15.06.png?alt=media\&token=1994c0fe-f56d-4c36-8bfb-4bb498d7af05)
{% 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` .

![](https://2402691658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHdBvXuUTTvADT4CXrm-1972196547%2Fuploads%2Fo3EG8uL4bHG5JI1e70QA%2FScreen%20Shot%202022-08-17%20at%2012.15.14.png?alt=media\&token=f95a2400-181d-4456-88da-3a86f855ffa3)
{% endtab %}
{% endtabs %}

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

![](https://2402691658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHdBvXuUTTvADT4CXrm-1972196547%2Fuploads%2FUaw2smGejhm5RINeNlOh%2FScreen%20Shot%202022-08-16%20at%2016.41.32.png?alt=media\&token=a9e06b43-2856-42d5-9ebb-fa6c0fd4a7d6)

## 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.