Quick Start

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

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

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

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

Linux — extract the archive and run the bash installer:

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

The installer places Studio, Runner, and Management in your Applications folder, creates start menu / desktop shortcuts, and registers Management as a background service that starts automatically with the OS (a Windows Service on Windows, a systemd --user service on Linux).

The installer starts the KlangoRPA Management service for you — open http://localhost:8766 in your browser to reach the Web Console. No manual step needed.

If you installed with -NoService / --no-systemd, start it manually instead and keep it running in the foreground:

# Windows
cd management
.\KlangoRPA.Backend.exe

# Linux
klango-management

The installer already registered the Runner to start with the OS — it just needs a backend URL and API key before it can start. On Windows, it defaults to Interactive Mode: Windows auto-logs into an account you chose during install, and the Runner starts there in a real, visible session — needed because bots that open a browser or any GUI window (headed Playwright, pyautogui, tkinter, etc.) can't be seen at all from a plain Windows Service (it runs in Session 0, which has no desktop). See the Runners doc for the full explanation and how to opt into the simpler headless-only Service mode instead.

In the Web Console, go to Runners → New Runner → Copy API Key (shown once — save it now). Then run the setup wizard:

# Windows — Start Menu → KlangoRPA → KlangoRPA Runner Setup
# or:
KlangoRPA.Runner.exe --setup

# Linux
klango-runner --setup

Enter the Management server URL (http://localhost:8766) and the API key from above.

Linux — the service is already enabled and starts automatically; restart it to pick up the new config:

systemctl --user restart klango-runner

Windows — reboot; Windows logs in automatically and starts the Runner from there as a tray icon (no big console window — bots can still open a browser). To test without rebooting, trigger the same Scheduled Task manually instead:

Start-ScheduledTask -TaskName "KlangoRPA Runner"

After this one-time setup, the Runner starts automatically with the OS on every reboot. Check the Web Console's Runners page — it should appear as Online. If you need a manual Startup-folder shortcut instead, see Tray Icon (Windows) — the shortcut must point at KlangoRPA.Runner.Tray.exe, not "Runner Setup".

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

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.