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:
| Credential | Purpose |
|---|---|
| Invitation key | Redeems 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 login | Gives the Agent access to your chosen model service. This access is separate from your invitation key. |
| SSH credentials | Connects to your own server when you use Server mode. |
Download and activate EvoLab#
- Open the Download page.
- Paste your invitation key into Invitation key and select Verify.
- After verification, download the App package for your computer and the
evolab-activation.jsonfile under Activation file. Available platforms depend on the packages currently listed on the download page. - Extract the entire package and keep its accompanying files together.
- 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 anevolabexecutable 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.