> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spine.altician.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Spine Helper Setup

> Install and configure the Spine Helper companion app

## Download

Download the Spine Helper for your platform:

| Platform              | Download                                                                                      | Requirements                                                                   |
| --------------------- | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| macOS (Apple Silicon) | [Download DMG](https://dl.altician.com/releases/latest/Altician-Spine-Helper-macos-arm64.dmg) | M1/M2/M3/M4 Mac, macOS 12+, 16 GB RAM                                          |
| Windows               | [Download ZIP](https://dl.altician.com/releases/latest/Altician-Spine-Helper-windows-cpu.zip) | Windows 10/11 x64, Intel i7-10700 / AMD Ryzen 5 5600X or equivalent, 16 GB RAM |

## macOS Installation

1. Download the DMG file.
2. Open the DMG and drag **Altician Spine Helper** to your Applications folder.
3. Launch the app from the Applications folder.
4. Double-click the app to launch — macOS will block it on first run.
5. Go to **System Settings → Privacy & Security**.
6. Scroll down and click **"Open Anyway"** next to the blocked app.

> This is required because the app is not yet notarized by Apple. You only need to do this once — future launches will open normally.

7. The Helper will connect to the browser automatically.

## Windows Installation

1. Download and extract the ZIP file.
2. Run `Altician Spine Helper.exe`.
3. Launch the app.
4. Windows SmartScreen will show a warning.
5. Click **"More info"** → **"Run anyway"**.

> This is required because the app is not yet code-signed. You only need to do this once — future launches will open normally.

6. The Helper will connect to the browser automatically.

## GPU Configuration

| Platform | GPU Acceleration | Notes                                                |
| -------- | ---------------- | ---------------------------------------------------- |
| macOS    | Apple MPS        | Automatic on Apple Silicon                           |
| Windows  | CPU              | GPU acceleration (CUDA) planned for a future release |

## Verifying Connection

Once the Helper is running, the app shows a connection status indicator in the right panel:

* **Connected** — Helper is running and ready
* **Disconnected** — Helper is not running or unreachable

The Helper runs on `localhost:18765`. Ensure no firewall is blocking this port.

<img src="https://mintcdn.com/altician/0YBh5K6l-27QqsAD/images/helper-guide.png?fit=max&auto=format&n=0YBh5K6l-27QqsAD&q=85&s=009e57f725e8b1aa97fdb5a66853355f" alt="Helper connection guide" width="320" height="400" data-path="images/helper-guide.png" />