Skip to content
DocumentGetting started

Installation & activation

2 min read

Download the right package for your computer and activate your installation.

On this page

Before you begin#

Prepare the invitation key provided by the EvoLab team and decide how you will access a model. Depending on your model and where you run EvoLab, you may also need a model provider's API key, an authenticated Codex account, or SSH connection details for a remote Linux server.

These credentials serve different purposes:

CredentialPurpose
Invitation keyRedeems download access on the website. Each redemption grants one installation license.
Activation file (evolab-activation.json)Activates your installation on first launch. It contains private authorization information; keep it safe.
Model API key or subscription loginGives the Agent access to your chosen model service. This access is separate from your invitation key.
SSH credentialsConnects to your own server when you use Server mode.

Download and activate EvoLab#

  1. Open the Download page.
  2. Paste your invitation key into Invitation key and select Verify.
  3. After verification, download the App package for your computer and the evolab-activation.json file under Activation file. Available platforms depend on the packages currently listed on the download page.
  4. Extract the entire package and keep its accompanying files together.
  5. Place the activation file: on Windows, put it beside evolab.exe. On macOS, follow the download page instructions and put it in Downloads or beside the EvoLab .app. If your package contains an evolab executable instead, you can place the file beside that executable.

First activation binds the license to the machine running the EvoLab backend: your computer in Local mode, or the remote server in Server mode. Contact the EvoLab team if you need to move your license to another computer or server.

Your browser download session lasts 24 hours after redemption. This window applies to downloads; an installed application renews its existing authorization. If a download is interrupted, return to the original browser to continue.