# Installing Spectra AI

Follow these steps to set up the SpectraAI backend and the Web Interface on your system.

***

### 1. Preparation

Before downloading the files, prepare a dedicated location for the software:

1. Navigate to a location on your computer where you want to store the software.
2. Create a new folder and name it **`SpectraAI`**.

### 2. Download Files

1. Visit the official download repository: [**Mega.nz Download Link**](https://mega.nz/folder/ZTIQRSxK#YPZF2RTwSWCg-jnX_UioQQ)
2. Download the required executable files. You must choose between the **Stable** release or the **Beta** release.

#### Option A: Stable Release (Recommended)

Download these two files:

* `SpectraAI.exe`
* `WebUI.exe`

#### Option B: Beta Release

If you wish to test new features, download these two files instead:

* `SpectraAI_beta.exe`
* `WebUI_beta.exe`

**Important:** *Move the two downloaded files into the **`SpectraAI`** folder you created in Step 1. Both files must reside in the same directory.*

***

### 3. Install and Run the Backend

The backend (SpectraAI.exe) handles the core logic, system detection, and resource management.

{% hint style="info" %}
Be sure to have GPU drivers installed before the next step
{% endhint %}

1. Double-click **`SpectraAI.exe`** (or `SpectraAI_beta.exe`) to run it.
2. **Automatic Configuration:** The software will automatically detect your system specifications and begin downloading and installing the necessary dependencies.

> **⚠️ Note on Installation Time:** > This process **will take some time** as it involves downloading, installing, and verifying large files.\
> **Please be patient.** If the window appears inactive, it is **not stuck**; it is working in the background. Do not close the window.

3. **Activation:** Once the installation and verification are complete, the console will prompt you to enter your **Key**. You only need to do this the first time you run the software.
4. Upon entering a valid key, the installation will be marked as successful.

***

### 4. Launch the Web Interface

Once the backend is running, you can launch the user interface.

1. Double-click **`WebUI.exe`** (or `WebUI_beta.exe`).
2. A terminal window will open and display a local address: `http://localhost:3000`.
3. Open your web browser and navigate to that link (or click it directly from the terminal if your terminal supports it).

#### Troubleshooting the Interface

If you open the link and see a **"Loading..."** screen that does not go away:

* **Check the Backend:** Ensure that `SpectraAI.exe` is still open and running.
* **Wait for Initialization:** The backend might still be loading essential components. Wait a few moments for the backend to fully initialize, and the WebUI menu will appear automatically.


---

# 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://spectra-2.gitbook.io/spectra-ai/setup/installing-spectra-ai.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.
