Skip to main content
Optexity uses a declarative model for browser automation. Define what actions to perform, and Optexity handles the how using AI-assisted element location.

Overview

Complete Example

Properties

PropertyTypeDefaultDescription
urlstrStarting URL—use the URL closest to your target to reduce navigation steps
browser_channel"chromium" | "chrome""chromium"Browser to use
os_emulation"windows" | "linux" | nullnullOS user-agent to emulate; null uses the default system OS
max_retriesint0Total number of run attempts. 0 = no retry, 1 = one retry, etc.
expected_downloadsint0Number of expected downloads (automation waits for completion)
parametersParametersInput, secure, and generated variables
nodeslist[action_node | for_loop_node | if_else_node]Ordered list of actions

Parameters

Three types of parameters control data flow:
TypePurposeExample
input_parametersValues provided before executionUsername, search queries
secure_parametersSensitive data from secure storagePasswords, API keys
generated_parametersValues extracted during executionOrder IDs, confirmation numbers
See Parameters for detailed usage.

Node Types

NodePurposeDocumentation
action_nodeSingle atomic actionAction Node
for_loop_nodeIterate over valuesFor Loop Node
if_else_nodeConditional executionIf Else Node

Browser Channel

ChannelUse When
"chromium"Default, works for most sites
"chrome"Site requires Chrome specifically, or automation is unreliable with Chromium

Expected Downloads

Set this to wait for file downloads to complete:
The automation waits until all expected files are downloaded before completing.

OS Emulation

Override the OS reported in the browser’s user-agent string:
ValueUse When
nullDefault — uses the host system’s OS (recommended for most sites)
"windows"Site behaves differently on Windows (e.g. Windows-only portals)
"linux"Site behaves differently on Linux
Only set os_emulation when a site serves different content or layouts based on the OS. Leave it as null otherwise.

Max Retries

Control how many times the full automation reruns when an unexpected error occurs:
ValueBehavior
1 (default)Runs once; fails immediately on error
2Runs up to twice (1 retry)
3Runs up to three times (2 retries)
max_retries is the total number of attempts, not the number of extra retries. AssertionError failures are never retried regardless of this value.
See Timing & Retries for controlling per-element retry behavior (max_tries) vs. full-automation retries (max_retries).