Installation

Installing the Workbench on Linux directly. Desktop users: Workbench Win (Windows) or Workbench Mac (planned).

Prerequisites

All installations require PostgreSQL 12+ as the metadata store. The Workbench creates its own schema for user accounts, recipes, datasets, and configuration. For the frontend, Node.js 18+ is required. The backend requires Python 3.10+.

Manual Installation

Clone the repository, install Python dependencies from requirements.txt, install Node.js dependencies with pnpm install, configure the PostgreSQL connection, and start the backend and frontend servers.

Workbench Win (Windows Desktop)

Workbench Win is a licensed-but-free Windows desktop application — currently under construction. When complete, it will bundle the full Workbench platform with Python and all dependencies in a single .exe installer with no command-line setup required. In the meantime, see workbench-win.sentuny.com for status.

Workbench Mac (macOS Desktop)

A macOS desktop application with the same easy-install approach as Workbench Win. Under consideration. Technically-inclined macOS users can run the open-source Workbench directly — it works on macOS for development and production.

After installation: Log in as admin@example.com (password: admin123) and change the password immediately. See the Configuration Guide for post-installation setup.
← Overview 📋 Contents Post-Installation Configuration →