PyRPA Studio User Guide

Everything you need to know — from installation to advanced AI features.

1 Installation

1. Download PyRPA Studio from pyrpastudio.com
2. Run the installer (PyRPA_Studio_Setup.exe)
3. Follow the setup wizard — default settings are recommended
4. Launch from Start Menu or Desktop shortcut

2 The Interface

The sidebar on the left gives you access to five main sections:

• Builder — Create and edit automation workflows
• Runner — Execute workflows and see live output
• Recorder — Record actions to auto-generate workflows
• Inspector — Examine UI elements on your screen
• Settings — License activation and AI usage

Your plan badge (FREE or PRO) appears at the bottom of the sidebar.

3 Smart Screen Recorder

The fastest way to create a workflow:

1. Click Recorder in the sidebar
2. Click Start Recording
3. Perform your task: click buttons, type text, navigate websites
4. Click Stop Recording
5. Review the generated workflow in the Builder
6. Save your workflow

4 Workflow Builder

The Builder is where you create and edit workflows. Each workflow is a sequence of steps, and each step is an action.

Adding Steps

1. Click + Add Step
2. Choose an action category (Web, Desktop, File, Flow)
3. Select the specific action
4. Fill in the parameters (selector, text, URL, etc.)
5. Drag steps to reorder

Variables

Workflows support dynamic variables:

• Set with flow.set_variable
• Reference with ${variable_name} in any field
• Built-in: ${timestamp}, ${date}, ${random}

5 Action Reference

6 Running Workflows

1. Go to the Runner tab
2. Select a workflow file (.yaml)
3. Click Run
4. Watch the live execution log
5. Stop anytime with the Stop button

7 Element Inspector

1. Click Inspector in the sidebar
2. Click Start Inspecting
3. Hover over any element on screen
4. See element type, properties, bounding box, and selectors
5. Click Copy Selector to use in your workflow

Use Browse Tree to explore the full UI element hierarchy of any window.

8 AI Features PRO

AI Vision Scraping

AI takes a screenshot and reads the page visually — no CSS selectors needed:

1. Add a web.smart_scrape step
2. Describe what to extract: "extract all product names and prices"
3. AI returns structured data
4. Export to CSV/Excel

AI Workflow Editor

Describe changes in plain English:

• "Add a 3-second wait after each click"
• "Loop through all table rows and extract the email column"
• "Add error handling if the login button isn't found"

AI Credits

Pro includes $6/month. Track usage in Settings > AI Usage. Credits reset on the 1st of each month.

9 Chrome Profile Mode PRO

For sites requiring device trust, saved cookies, or 2FA sessions:

1. Set browser: "chrome" in workflow variables
2. PyRPA launches your actual Chrome browser
3. Saved logins, cookies, and fingerprint are preserved

10 Activating Your Pro License

1. Purchase at pyrpastudio.com/pricing
2. Check email for your key (format: PYRPA-PRO-XXXXXXXX-XXXXXXXX)
3. Open PyRPA Studio > Settings
4. Paste your key and click Activate License
5. "Plan: Pro" appears in green — all features unlocked

11 Workflow File Format (YAML)

Workflows are saved as .yaml files:

name: Google Search Example
variables:
  browser: "chromium"
  search_term: "PyRPA Studio automation"

steps:
  - action: web.open
    url: "https://www.google.com"

  - action: web.type
    selector: "textarea[name='q']"
    text: "${search_term}"

  - action: web.click
    selector: "input[name='btnK']"

  - action: flow.wait
    seconds: 3

  - action: web.screenshot
    path: "search_result.png"

Chrome Profile Mode example (Pro):

name: Bank Balance Check
variables:
  browser: "chrome"

steps:
  - action: web.open
    url: "https://www.usbank.com"

  - action: web.wait
    selector: "#account-balance"
    timeout: 30

  - action: web.smart_scrape
    prompt: "Extract the checking account balance"

12 Tips & Best Practices

• Start with the Recorder — record first, then refine in the Builder
• Use waits — add web.wait or flow.wait between steps
• Name variables descriptively — ${login_email} not ${var1}
• Test incrementally — run after adding each section
• Save often — YAML files are lightweight
• Close Chrome before running browser: "chrome" workflows
• Be specific with AI — "extract the table with columns: Date, Amount, Description" works better than "get the data"

! Troubleshooting