Config fields

Define the variables your script needs, with a GUI instead of code.

Each field becomes a script input. Whatever the user types into the GUI is available in your code as inputs["field_name"].

Fields and code

Pybes passes user-entered values into your script through a single inputs dictionary.

The basic pattern

Load the input values at the top of your script and read each field with inputs["field_name"]:

import sys
import json

with open(sys.argv[1], encoding="utf-8") as f:
    inputs = json.load(f)

# Access values by field name
folder = inputs["input_folder"]
name = inputs["user_name"]

Watch the types

Every field value arrives as a string. If you’re using numbers or checkboxes, convert them in code:

# Everything comes in as a string
count = int(inputs["count"])           # convert to int
price = float(inputs["price"])         # convert to float
flag = inputs["enabled"] == "true"     # checkbox -> True/False
date = inputs["target_date"]           # "2026-04-12" string

Field card layout

Each field is shown as a collapsible card with three zones in its header:

• Drag handle — grip for reordering
• Name input — edit the field’s name
• Timing toggle + expand arrow — switch between Fixed/Runtime and expand the detail settings

Field types

Input timing

Fixed (preset)

Entered directly in the fields panel of the editor. Values persist across sessions — best for values that rarely change.

Runtime

Entered in a modal when you click Run. Last-used values can be auto-restored — best for values that change each time.

Adding fields

Manually

Click Add field.

Auto-detect

Paste code containing inputs["variable_name"] and Pybes detects any undefined variables. Click a detected variable to turn it into a field.

Editing fields

Click the expand arrow to open the settings panel.

Common settings

• Field type
• Timing (Fixed / Runtime)
• Multi-select (File + Runtime only)

Type-specific settings

Deleting fields

A confirmation dialog gives you two choices:

• Delete and copy fix prompt — deletes the field and copies an AI prompt asking the model to update the code accordingly
• Delete only — just delete the field

Reordering

Drag the grip icon to change the field order. Order is auto-saved.

Field card styles

Change the look of field cards from the settings panel.

Validation

Field values are validated in real time:

• Required-field check
• Numeric range
• Integer-only check
• File extension
• Path existence
• Text pattern (custom regex or format)