> For the complete documentation index, see [llms.txt](https://spectra-2.gitbook.io/spectra-ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://spectra-2.gitbook.io/spectra-ai/setup/environment-setup-and-software-installation.md).

# Start here — SpectraAI guide

Start here if you are installing SpectraAI for the first time, moving to another version, or trying to understand a setting. This guide covers the loader, the current WebUI, model conversion, capture, mouse and controller output, recoil, and training tools.

**Guide checked: 29 September 2026.** Screenshots show the current WebUI in standby. A screenshot's selected values are examples from that session, not recommended settings for every game. Some controls appear only after enabling their parent feature, selecting an algorithm, or opening **Advanced Settings**. If your menu looks different, check the version selected in the loader.

## First-time setup: follow this order

1. [Install Python and launch through the loader](/spectra-ai/setup/environment-setup-and-software-installation/installation-and-setup/installation-loader-and-first-launch.md).
2. [Choose and configure capture](/spectra-ai/setup/environment-setup-and-software-installation/capture-detection-aim-and-recoil/capture-methods-and-obs-setup.md).
3. [Connect your output device](/spectra-ai/setup/environment-setup-and-software-installation/devices-and-display/mouse-devices-and-locks.md), or follow the [controller](/spectra-ai/setup/environment-setup-and-software-installation/devices-and-display/virtual-controller.md) / [Titan Two](/spectra-ai/setup/environment-setup-and-software-installation/devices-and-display/titan-two.md) instructions.
4. [Select a detection model](/spectra-ai/setup/environment-setup-and-software-installation/capture-detection-aim-and-recoil/models-and-conversion-buttons.md), or configure [Color Detection](/spectra-ai/setup/environment-setup-and-software-installation/capture-detection-aim-and-recoil/color-detection.md).
5. [Choose target classes, aim points, and activation keys](/spectra-ai/setup/environment-setup-and-software-installation/capture-detection-aim-and-recoil/aim-assist-and-algorithms.md).
6. Start AI and inspect a controlled test scene. Tune one feature at a time.
7. [Save a configuration for the selected model](/spectra-ai/setup/environment-setup-and-software-installation/reference-and-help/settings-and-configurations.md).

## Understand the four separate parts

| Part                          | What it does                                                                       | What it does not prove                                                                 |
| ----------------------------- | ---------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| Loader                        | Downloads versions, chooses the active version, launches executables               | A completed download does not mean dependencies, license, capture, or device are ready |
| Environment manager / backend | Sets up the runtime, authenticates, captures images, detects targets, sends output | An open console does not mean inference has started                                    |
| WebUI                         | Browser control panel, normally on port 3000                                       | Opening the page does not start AI or move a device                                    |
| Capture and output hardware   | Supplies video and sends mouse/stick actions                                       | A connected output device does not prove that the video feed is correct                |

**Start AI** starts processing. Feature switches such as **Aimbot Enabled**, **Triggerbot Enabled**, and **Enable RCS** determine what that processing is allowed to do. Each feature also has an activation control. All three layers matter: running session, feature enabled, activation condition satisfied.

![Home: capture, detection, output status, and Start AI](https://content.gitbook.com/content/yQTms6SMZRY4r5c3Q2F4/blobs/WMcPyub1NEUUqrmbwF6s/assets/home.jpg)

## Find a setting

| WebUI location                   | Guide                                                                                                                                                                                                                                                      |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Home → Video Input               | [Capture methods and OBS setup](/spectra-ai/setup/environment-setup-and-software-installation/capture-detection-aim-and-recoil/capture-methods-and-obs-setup.md)                                                                                           |
| Aim → Assist → Advanced Settings | [Aim algorithms, targeting, offsets, prediction, keys](/spectra-ai/setup/environment-setup-and-software-installation/capture-detection-aim-and-recoil/aim-assist-and-algorithms.md)                                                                        |
| Aim → Tracking                   | [ByteTrack and target identity](/spectra-ai/setup/environment-setup-and-software-installation/bytetrack-and-target-identity.md)                                                                                                                            |
| Aim → Fire                       | [Triggerbot and Flickbot](/spectra-ai/setup/environment-setup-and-software-installation/capture-detection-aim-and-recoil/triggerbot-and-flickbot.md)                                                                                                       |
| Aim → Recoil                     | [Visual paths, simple recoil, legacy patterns](/spectra-ai/setup/environment-setup-and-software-installation/capture-detection-aim-and-recoil/recoil-profiles-and-visual-paths.md)                                                                         |
| Detection → AI Models            | [Libraries, formats, TensorRT / ONNX / OpenVINO conversion](/spectra-ai/setup/environment-setup-and-software-installation/capture-detection-aim-and-recoil/models-and-conversion-buttons.md)                                                               |
| Detection → Color Detection      | [Color filters and all colorbot controls](/spectra-ai/setup/environment-setup-and-software-installation/capture-detection-aim-and-recoil/color-detection.md)                                                                                               |
| Devices → Mouse                  | [Serial, Kmbox, key masking, axis locks](/spectra-ai/setup/environment-setup-and-software-installation/devices-and-display/mouse-devices-and-locks.md)                                                                                                     |
| Devices → Controller             | [Virtual controller](/spectra-ai/setup/environment-setup-and-software-installation/devices-and-display/virtual-controller.md), [Titan Two response tuning](/spectra-ai/setup/environment-setup-and-software-installation/devices-and-display/titan-two.md) |
| Devices → Display                | [Debug and fuser visuals](/spectra-ai/setup/environment-setup-and-software-installation/devices-and-display/debug-and-fuser-visuals.md)                                                                                                                    |
| Tools → Aim Trainer              | [Recording, importing sessions, GRU / GAN training](/spectra-ai/setup/environment-setup-and-software-installation/training-and-benchmarks/aim-trainer.md)                                                                                                  |
| Tools → Benchmarks               | [Reaction test and performance checks](/spectra-ai/setup/environment-setup-and-software-installation/training-and-benchmarks/benchmarks.md)                                                                                                                |
| Settings                         | [Saved presets, GPU Device ID, AMD compatibility](/spectra-ai/setup/environment-setup-and-software-installation/reference-and-help/settings-and-configurations.md)                                                                                         |

## Before asking support

Use the [troubleshooting checklist](/spectra-ai/setup/environment-setup-and-software-installation/reference-and-help/troubleshooting.md). Include the selected version, GPU, model filename and format, capture method, output device, exact error, and what you already tested. Never post a license key, account password, or credential file. [Updates and backups](/spectra-ai/setup/environment-setup-and-software-installation/updates-backups-and-rollback.md) explains which files to preserve.
