tThreadrun Download

Install

This page helps you download Threadrun, get this computer ready to run agents, and keep the app up to date.

Requirements

  • macOS: version 12 or later, on Apple silicon or Intel.
  • Windows: Windows 10 or 11, 64-bit.
  • Docker Desktop: runs your threads on this computer. On Windows, Docker Desktop uses WSL 2.
  • Internet access: the first start downloads the sandbox image, which is about 2.5 GB.
  • Memory: each thread's sandbox is limited to 2 GB of memory and 2 CPUs.

Download

Get the latest version from threadrun.dev.

  • macOS: unzip the download and move Threadrun to your Applications folder.
  • Windows: unzip the download and run threadrun.exe.
Threadrun isn't notarized yet, so your computer warns you the first time you open it. On macOS, right-click Threadrun and choose Open. On Windows, if SmartScreen warns you, choose More info → Run anyway.

Set up Docker on this computer

When Threadrun opens and this computer isn't running agents yet, the start screen shows two steps. Each one tells you what to do next.

  1. Docker. Threadrun checks whether Docker is installed and running.
    • If Docker isn't installed, Threadrun shows the install steps. Press Get Docker, install it, then press I've installed it.
    • If Docker is installed but not running, press Start Docker. Threadrun opens Docker Desktop and checks again on its own.
  2. Threadrun runtime. Once Docker runs, press Start runtime. The first start downloads the images. Threadrun shows its progress above the button. When the runtime is ready, the start screen shows the composer.

The runtime runs on this computer, so threads stop when it sleeps. Keep the computer awake, or connect a server to run threads around the clock.

Install Docker on macOS

Download Docker Desktop for Mac (Apple silicon or Intel) and drag it to Applications, or run this command in Terminal:

brew install --cask docker

Open Docker once and accept its terms. OrbStack also works.

Install Docker on Windows

Run these commands in PowerShell, then restart your computer:

wsl --install
winget install Docker.DockerDesktop

Open Docker Desktop once and keep the WSL 2 backend selected.

Skip local Docker with your own server

You don't need Docker on this computer if you connect your own Ubuntu server. Open Settings → Runners from the sidebar, then press Add a server. Threads, factories and loops then run on the server, and they keep going while this computer sleeps. See Your server for the setup steps.

Update Threadrun

Threadrun updates itself. A few seconds after it starts, and every six hours after that, it looks for a new version. When one is out, it downloads it in the background, checks it against its published checksum and puts it in place of the current app.

When the update is ready, the top bar shows Restart to update to and the new version. Click it to restart into the new version, or keep working: the next start runs it. Your threads stay where they are.

If the update can't be installed, for example because the app's folder is read-only, the top bar shows Threadrun and the new version is available instead. Click it to download the new version from threadrun.dev, then replace the app in Applications (macOS) or in the folder you unzipped it to (Windows).

To check the runtime on this computer, open Settings → Runners. Under This computer, the Version row shows the runtime's version.

Servers follow the app: once the app is updated, each server's runner is updated too. See Your server.