Skip to main content
Reagent works with REAPER through the Bridge, a small script that runs inside REAPER and lets Reagent read and edit your project. You set it up in step 4.

Before You Start

You need:
  • A Mac or Windows PC that meets the System Requirements.
  • REAPER 7.0 or later (reaper.fm), on the same computer and user account as Reagent.
  • The free SWS extension. Reagent needs it for media items and doesn’t warn you if it’s missing, so install it first.
  • Enterprise accounts: an endpoint URL, API key and model ID from your IT team.
  1. Quit REAPER.
  2. Download the version for your platform from sws-extension.org and follow the install instructions there.
  3. Open REAPER, choose Actions > Show action list… and type SWS in the Filter box. If you see actions that start with SWS/S&M:, SWS is installed.

1. Download and Install Reagent

  1. Go to reaperagent.com/download and click Download for macOS.
  2. Open the .dmg file and drag Reagent into your Applications folder.
  3. Open Reagent from Applications.

2. Sign In

Sign-in happens in your web browser, not inside the app.
  1. In Reagent, click Sign in to Reagent. Your browser opens the Reagent sign-in page.
  2. Type your email.
    • Have an account? Enter your password and click Log in.
    • New to Reagent? Click Sign up when the page says No account found for this email. Enter your name, email and a password (at least 8 characters), then click Create account. If the page says it sent a confirmation link, click it in the email.
New accounts include free trial credits. See Plans and Credits.
The browser then shows Opening Reagent and hands you back to the app. If your browser asks whether to open Reagent, allow it. If the page shows an Open Reagent button, click it. Reagent waits up to 10 minutes for you to finish in the browser. If you take longer, close the tab, or the button doesn’t work, click Cancel in Reagent if it’s still waiting, then Sign in to Reagent again.

3. Answer the Welcome Questions

The first time you sign in, click Get Started, enter a Display Name, answer Tell us about yourself or click Skip, then click Start Chatting.

Connect Your Organization’s AI Endpoint

After the welcome questions, or right after sign-in on another computer, a Custom Endpoint window asks for your organization’s AI endpoint. You can’t use Reagent until it connects.
  1. Enter the Endpoint URL, API key and Model ID from your IT team. Leave the other fields at their defaults unless IT says otherwise.
  2. Click Apply. Reagent tests the endpoint before it saves anything.
  3. When the window shows Connected, click Continue. If the test fails, see Custom Endpoint troubleshooting.
You enter the endpoint again on each new computer, and after you log out or your sign-in session ends. To change it later, or for every option, see Custom Endpoint.

4. Connect Reagent to REAPER

Each time Reagent starts, it copies the Bridge script, reagent_bridge.lua, into a reagent folder inside REAPER’s Scripts folder. You load it into REAPER’s action list once on each computer.
1

Open REAPER's action list

Open REAPER (any project works) and choose Actions > Show action list….
2

Load the script (first time only)

Click New action… and choose Load ReaScript…, then browse to the reagent folder for your platform:On macOS, if you can’t see the Library folder, press Cmd+Shift+G in the file dialog and paste the macOS path from the table.Select reagent_bridge.lua and click Open. The list now shows Script: reagent_bridge.lua.Portable install or a different resource folder? Tell Reagent where it is in Settings > Connectors first. Then browse to the reagent folder inside the Scripts folder you chose, not the one in the table. See REAPER in a Custom Location.
3

Run the Bridge

Select Script: reagent_bridge.lua and click Run. The Bridge runs in the background and doesn’t open a window. Run this step each time you open REAPER, unless you start the Bridge automatically.
REAPER's Actions window showing Script: reagent_bridge.lua in the list, with the New action... and Run buttons at the bottom
4

Check the connection

Reagent has no connection light. To check, ask:

5. Send Your First Request

Reagent sees what’s selected in REAPER. Try your first few requests on a copy of a project.
  1. In REAPER, select a track.
  2. In Reagent, type a request in the box that says How can I help you today? For example:
  3. Press Enter to send.
  4. Reagent starts in Default permissions, so it asks before it changes your project or your files. Click Allow to go ahead, or Deny to skip that change and let Reagent carry on. To change how often it asks, see Permissions.
Each change Reagent makes in REAPER gets its own entry in REAPER’s undo history, so Cmd+Z (macOS) or Ctrl+Z (Windows) undoes it. See Undo and Recovery. For more to try, see Example Workflows.

Start the Bridge Automatically

Optional: make the Bridge SWS’s global startup action, so it starts whenever you open REAPER.
1

Check for an existing startup action

SWS keeps only one global startup action, so this replaces any you already have. To check, run SWS/S&M: Show project/global startup actions in the action list.
2

Copy the Bridge's command ID

In the action list, type reagent in the Filter box. Right-click Script: reagent_bridge.lua and choose Copy selected action command ID.
Right-click menu on Script: reagent_bridge.lua with Copy selected action command ID highlighted
3

Open the SWS startup action setting

Change the filter to global start. Select SWS/S&M: Set global startup action and click Run.
Action list filtered by global start, with SWS/S&M: Set global startup action selected
4

Paste the ID and save

Paste the command ID into the Set global startup action box and click OK.
The Set global startup action dialog with the Bridge's command ID pasted in
Once the startup action starts the Bridge, don’t run it yourself. If REAPER asks whether to terminate instances or start a new instance, click Abort. Never choose New instance: two Bridges carry out every change twice.

Set Up Another Computer

Your account and profile follow you, so another computer skips the welcome questions. On each new computer:
  1. Install REAPER and SWS (Before You Start).
  2. Install Reagent and sign in (steps 1 and 2).
  3. Enterprise accounts: enter your endpoint again when the Custom Endpoint window opens (Connect Your Organization’s AI Endpoint).
  4. Load and run the Bridge (step 4), and optionally start it automatically.

If Something Doesn’t Work

Chat

Talk to Reagent, attach files and follow its work.