Installation and prerequisites
Most people only need to install the desktop app. Run from source only when developing Workrun, contributing code, or modifying the desktop app.
Download Workrun
Section titled “Download Workrun”Download the latest release from Workrun GitHub Releases.
- Under Assets on the latest release, choose the installer for your operating system and CPU architecture.
- Complete your operating system’s installation flow.
- Launch Workrun.
The release page lists the installers and notes that are actually available for the current version. Always download installers from that page, not from third-party sites.
First launch
Section titled “First launch”On first launch, choose a personal or team workspace. Personal mode requires a profile but no login; team mode requires a Workrun Server address and sign-in. See Team workspaces. Then configure model access:
- Open Settings → Models.
- Enter an API key for one provider you want to use.
- Settings save automatically.
- Follow the 5-minute quickstart to create your first workflow.
Do not create a model profile or enter a model ID manually. Workrun provides a built-in model catalog; select a model for the provider you configured in the Agent node. For Ollama, enter a local or remote Ollama endpoint instead of an API key.
Run from source (developers only)
Section titled “Run from source (developers only)”To develop or modify Workrun, prepare:
- Node.js 24 or newer;
- pnpm 12 (use the exact version in the root
package.json→packageManager); - the Rust toolchain and Tauri build dependencies for your platform;
- network access:
uvdownloads Python and dependencies while developing Python Apps.
Clone the repository and start desktop development:
git clone https://github.com/1111mp/workrun-app.gitcd workrun-apppnpm installpnpm app:devCommon development commands
Section titled “Common development commands”# Start only the desktop frontendpnpm ui:dev
# Static checks and testspnpm typecheckpnpm oxlintpnpm testLocal development of the team service also requires MongoDB and authentication environment variables. See the current definitions in apps/server/src/env.validation.ts.