Install Spectra Resolve

To install Spectra Resolve, first download the installer file from the official ReversingLabs sources. Save the installer file somewhere on your system where you can easily access it.

Then you can choose to install Spectra Resolve in any of the following ways:

• automatically (recommended) - let the AI coding agent complete the setup
• manually - install all required tools yourself

Prerequisites

The following tasks should be completed before installing Spectra Resolve:

• Install any of the supported AI agents - Codex CLI, Claude Code CLI, or an OpenAI-compatible model for the built-in Spectra Agent. Multiple agents can be configured and installed at the same time.

• Install the required Python version. Resolve doesn't work without rl-protect, which requires Python 3.8 or newer.

• Make sure you have the latest pip version. Use the following command to upgrade pip.

python3 -m pip install -U pip

• Get a token for your user account. You can use rl-protect with a free Spectra Assure Community account or with a Spectra Assure Portal account. Community tokens have the prefix rlcmm, and Portal tokens have the prefix rls3c. The token is required for authenticating to ReversingLabs APIs.

Community account

1. Create a free account on the Spectra Assure Community website.

2. In your user profile on the Community website, create an access token. Provide a custom name for your token. Set the token expiration date or use the default value.

3. When a token is generated, it’s displayed only once. Copy the token and store it in a safe place. This is the only way to obtain the token you just created!

Portal account

1. If you're currently a Spectra Assure Portal user, create a token in your Portal user profile.

2. Set a name and expiration date for the token.

3. Copy the token and save it for later use.

Installation

1. Run the Spectra Resolve installer file in the directory where you downloaded it.

Windows - ZIP

1. Extract the contents of the installation package (the downloaded ZIP file).
2. Locate the Spectra Resolve.exe file.
3. Double-click on it to launch the application.

Windows - EXE

1. Locate the setup EXE file.
2. Double-click on it to execute it.
3. In the setup dialog, choose whether to install Spectra Resolve for all Windows users or only for the current user.

Linux - AppImage

If you downloaded an AppImage, you first need to mark it as an executable. This is done in any of the following ways:

From the UI

1. Locate the file.
2. Right-click on the icon and select Properties > Executable as Program.
3. After that, double-click on the icon to launch it.

From the Terminal

1. Locate the file and run the following from the Terminal:

chmod a+x Spectra-Resolve-*-linux-x86_64.AppImage

2. Next, launch the file:

./Spectra-Resolve-*-linux-x86_64.AppImage 

Linux - DEB

If you downloaded a DEB file, you can install it in any of the following ways:

From the UI

1. Locate the file.
2. Double-click on the icon and install it with the Software installation application.
3. After that, double-click on the icon to launch it.

From the Terminal

1. Locate the file and run the following from the Terminal:

sudo dpkg install ./Spectra-Resolve-*-linux-amd64.deb

2. Next, launch the application:

spectra-resolve

Linux - RPM

If you downloaded an RPM file, you can install it in any of the following ways:

From the UI

1. Locate the file.
2. Double-click on the icon and install it with the Software installation application.
3. After that, double-click on the icon to launch it.

From the Terminal

1. Locate the file and run the following from the Terminal:

sudo dnf install ./Spectra-Resolve-*-linux-x86_64.rpm

2. Next, launch the application:

spectra-resolve

2. Launch Spectra Resolve. The startup screen shows Checking this computer… while the application looks for Python, rl-protect and the supported coding agents.

AI-assisted setup

If Codex or Claude Code are already installed on the system, but Python or rl-protect are not, you can choose to Install with Codex CLI or Install with Claude Code.

Select any of those options to complete the automatic setup. The selected AI agent runs the whole installation procedure (Python, the VC++ runtime, rl-protect, and the PATH entry) and records the progress into the log.

The installation is performed only for the currently logged in user on your system.

Manual setup

The startup screen shows Prepare Spectra Resolve options if any of the required tools are missing.

If you have performed all actions from the Prerequisites section and Python is correctly installed, only rl-protect should be missing.

Select the option to install rl-protect. This runs pip install --user rl-protect in the background. On Windows, you may be prompted to install the Microsoft VC++ runtime, as rl-protect requires it.

3. Set up the connection to ReversingLabs APIs using your Spectra Assure Community or Spectra Assure Portal token.

From the bottom of the sidebar, select Settings > Connections > Add connection. In the dialog that opens, configure the fields listed in the following table.

Field	Description
Connection name	Provide a custom name for the connection (e.g. default or production). Only letters, digits and underscore are allowed in connection names.
API token	Provide the token for your Spectra Assure Community or Portal account. The account type is automatically detected from the token prefix (rlcmm- for Community, rls3c- for Portal). If you don't have an account, use the link in the dialog to create a free Community account. Depending on the detected account type, other options may become available in the dialog.
Portal URL	Required only when connecting to the Portal. Name of the Spectra Assure Portal instance associated with your account (example: my.secure.software).
Organization	Required only when connecting to the Portal. Name of the Spectra Assure Portal organization. The organization must exist on the specified Portal URL. The user account authenticated with the token must be a member of the specified organization and have the appropriate permissions. Organization names are case-sensitive.
Group	Optional, applies only when connecting to the Portal. Name of the Spectra Assure Portal group. The group must exist in the specified Portal organization. Group names are case-sensitive.

If needed, you can configure a proxy server, port, optional credentials, and a PEM CA bundle for TLS interception. Expand Proxy and CA certificates in the dialog to access these settings.

To complete the configuration, select Add connection. The new connection is added to the list. You can add more connections, remove previously added ones, and switch between them at any time.

Note that Spectra Resolve will automatically detect existing connections if you have used rl-protect on the same system before, and add them to the list. You can modify those connections if needed, or continue using them with Spectra Resolve.

Token safety

Connections are stored and managed by rl-protect. Spectra Resolve only remembers which connection is selected. Tokens are passed straight to rl-protect and are never written to the application's logs.

Optional tools

Spectra Resolve can integrate with several external tools to enable additional functionality. Those tools are not required for working with Resolve, but they can be useful. Git and GitHub integrations in particular can speed up the process of applying fixes through pull requests, and make it easier to view and approve proposed changes.

Currently, Spectra Resolve detects the existing installation and allows configuring the PATH in Settings > Tools for the following tools:

• Git (recommended)
• GitHub CLI (gh)
• opengrep

You can install them at any point during or after the Spectra Resolve installation process.

Updating Spectra Resolve

Spectra Resolve automatically checks for its own updates and for rl-protect updates in the background.

When a new version is available, a card appears at the bottom of the sidebar, from which you can directly perform the update. If needed, you can also check for updates manually with the Help > About Spectra Resolve > Check for updates menu option.

Troubleshooting

The following issues may appear during or after the installation process. Possible solutions are listed after each issue.

• "Checking this computer…" never finishes, or a tool that is installed cannot be detected. - The tool is likely not on the PATH that the application inherits. Set its path explicitly in Settings > Tools.

• rl-protect is installed but not found. - The pip --user does not put its scripts directory on PATH. Either add that directory to your PATH, or set the rl-protect path in Settings > Tools.

• rl-protect fails to run on Windows. - Install the Microsoft VC++ x64 redistributable.

• A coding agent is detected but every run fails. - The startup check verifies each agent with a short test query. If the query fails, that may indicate the agent is installed but not authenticated. Log into the agent with the appropriate CLI command, then select Try again in Spectra Resolve.