> For the complete documentation index, see [llms.txt](https://help.refractbot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.refractbot.com/installation/install.md).
# Install Refract
This guide gets Refract downloaded, installed, and logged in on Windows or Mac.
{% hint style="info" %}
**System requirements**
* Memory (RAM): `4 GB`
* Disk space: `5 GB`
* Windows 10/11, Windows Server 2016 or newer, or macOS 12 (Monterey) or newer
{% endhint %}
## Download the app
Downloads live in the **Download** tab of the dashboard: [dashboard.refractbot.com/download](https://dashboard.refractbot.com/download). Choose the version that matches your device and it will download.
One Windows download, two Mac downloads. Pick the one that matches your device.
The installer is roughly 101 MB, so the download can take a while on slower networks. Give it time before assuming it failed.
{% hint style="warning" %}
**Download not starting?** Make sure you click **Allow** if your browser asks about popups or downloads from the dashboard. If it still will not download, try a new Chrome user: click your profile picture in the top right of Chrome, add a new profile, and download from there.
{% endhint %}
## Install and log in
{% tabs %}
{% tab title="Windows" %}
{% stepper %}
{% step %}
#### Download for Windows
On the Download tab, click **Download for Windows**.
{% endstep %}
{% step %}
#### Run the installer
Open the downloaded `refract.exe` file. You can also find it in **File Explorer > Downloads**. Follow the on-screen instructions.
{% endstep %}
{% step %}
#### Log in
Log in with the same email and password you use for the dashboard. Refract does not use license keys; your account is your license.
{% endstep %}
{% endstepper %}
{% endtab %}
{% tab title="Mac" %}
{% stepper %}
{% step %}
#### Pick your Mac version
There are two Mac downloads. Click the Apple menu and choose **About This Mac** to check yours: an Apple M1/M2/M3/M4 chip means **Download for Apple Silicon**, and an Intel processor means **Download for Intel**.
{% endstep %}
{% step %}
#### Run the installer
Open the downloaded file and follow the on-screen instructions.
{% endstep %}
{% step %}
#### Log in
Log in with the same email and password you use for the dashboard. Refract does not use license keys; your account is your license.
{% endstep %}
{% endstepper %}
{% endtab %}
{% endtabs %}
{% hint style="success" %}
If the login details are correct, Refract opens and you are presented with the bot. You are ready to move on to setup.
{% endhint %}
{% content-ref url="/pages/rx6hhYbORqLcsI1HOYZW" %}
[Task Creation](/general-setup/task-creation.md)
{% endcontent-ref %}
## FAQ
Refract is open in Task Manager, but I can't find the window on my screen
This happens when the window has ended up off screen, usually after a monitor change. Here is how to bring it back ([video walkthrough](https://www.youtube.com/watch?v=ifVtvI8tZaY)):
1. Click the Refract window in the taskbar so it is selected.
2. Press **Alt + Spacebar** to open the window menu.
3. Press **M** to choose Move.
4. Use the arrow keys to move the window until it is somewhere visible, then press **Enter**.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://help.refractbot.com/installation/install.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.