Getting Started

Quick Start

From zero to a running bot in three steps: create your account, install the apps, record a workflow, and dispatch it on demand or on a schedule.

How KlangoRPA works

🎙️

Studio

Desktop app where you record bots by clicking through your workflow. Generates Python + Playwright scripts automatically.

⚙️

Runner

Headless process that polls the cloud for pending jobs and executes the bots on your machine or server.

🌐

Web Console

Browser dashboard for managing bots, runners, triggers, credentials, queues, and execution history.

Studio and Runner run on your machine. The Web Console and cloud backend orchestrate dispatch, history, and credentials. Your bots and scripts never leave your own machines unless you choose to share them.

Installation

Create a free account

Go to klangorpa.com/register and sign up. You get a permanent Free tier with 3000 executions/month — no credit card required.

Download the package

One download includes Studio, Runner, and the Web Console backend. Choose your OS:

🪟 Windows x64 (.zip)🐧 Linux x64 (.tar.gz)

Run the installer

Windows — extract the .zip and run the PowerShell installer:

cd KlangoRPA-win-x64
powershell -ExecutionPolicy Bypass -File .\install.ps1

Linux — extract the archive and run the bash installer:

tar -xzf KlangoRPA-linux-x64.tar.gz
cd KlangoRPA-linux-x64
bash ./install.sh

The installer places Studio, Runner, and the Web Console in your Applications folder and creates start menu / desktop shortcuts.

Start the Management backend

Open the KlangoRPA Management app (or runKlangoRPA.Backend from the install folder). It starts a local server on http://localhost:8766.

Open your browser at that address to reach the Web Console.

Management must be running for Studio and Runner to function. Keep it open in the background, or set it up as a service using the scripts in scripts/.

Your first bot

Set up a Runner

A Runner is the process that actually executes your bots. Start it with the setup wizard:

cd KlangoRPA.Runner
KlangoRPA.Runner --setup

When prompted, enter the Management server URL (http://localhost:8766) and the API key you generated in the Web Console under Runners → New Runner → Copy API Key.

After setup, run KlangoRPA.Runner without flags to start polling for jobs. You should see it appear as Onlinein the Runners page of the Web Console.

Record a bot in Studio

Open KlangoRPA Studio and log in with your account.
Click New Bot → Web Bot.
Enter a name, then click Start Recording. A Chromium browser opens.
Navigate to any website and click through the actions you want to automate — KlangoRPA captures each click, type, and navigation.
When done, click Stop in the Studio overlay.
Review the captured steps in the Map Edit panel. Adjust selectors if needed.
Click Publish to upload the bot to your Management server.

Run the bot

Go to the Web Console → Bots. Find your bot and click Run. Choose your Runner, then click Dispatch.

The job lands on your Runner, Python + Playwright execute the recorded steps, and the result appears in History.

What's next?

Studio guide — selectors, data sources, flow control, and desktop bots
Triggers — run bots on a schedule, on email, on a webhook, or on a file change
Assets & Vault — store credentials encrypted and inject them into bots at runtime

System requirements

Component	Windows	Linux
Studio	Windows 10 / 11 x64	Ubuntu 20.04+ · X11 or Wayland
Runner	Windows 10 / 11 x64	Ubuntu 20.04+ · Debian 11+ · Fedora 36+
Management	Any OS with .NET 8 runtime (bundled)
Python	3.9+ required on machines running the Runner