Getting started

A quick overview of Pybes — from first launch to running your first script.

What Pybes is

Pybes is a Windows desktop app that lets you run Python scripts without any environment setup.

Normally, running a Python script means installing Python, configuring the PATH, and installing libraries with pip. Pybes bundles all of that inside the app, so it works the moment you download it.

Who it’s for

• People who can’t write Python but want to run AI-generated code for real work
• Anyone who built a useful script but has no clean way to hand it off (with Pybes, a single .pybes file is enough)
• Anyone who wanted to automate Excel work or file operations but got stuck on the environment setup

What sets it apart

The two main screens

Pybes has two screens you’ll live in:

• Script list — where you manage, search, and run the scripts you’ve created
• Editor — where you edit the code, set up config fields, and see the results

Double-click a script in the list to open it in the editor. The editor shows your code and the console on the left, and config fields on the right.

First launch

The first time you open Pybes, the disclaimer appears. Review it, tick the agreement box, and click Accept. This screen only shows up once.

Creating a script

1. Click New on the script list
2. A new script opens in the editor with a starter template
3. The template already reads input values for you

The template

import sys
import json

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

# Write your code here

print("Done")

Two ways to build a script

You can either let AI write the code or write it yourself. If you’re not comfortable with Python, Workflow A is the recommended path.

Workflow A — generate with AI (recommended)

1. Click the Prompt button in the editor toolbar
2. A structured prompt is copied to the clipboard
3. Paste it into an AI chat (ChatGPT, Claude, Gemini, etc.)
4. Describe what you want done in your own words
5. The AI returns a Pybes-ready script
6. Copy the code and paste it into the Pybes editor
7. Pybes auto-detects the variables used in the code
8. Click a detected variable to turn it into a config field
9. Fill in the values and run

Workflow B — fields first, then code

1. Click Add field and create your fields
2. Configure each one (name, type, constraints)
3. Click Prompt to generate a prompt that includes the field definitions
4. Paste it into an AI chat
5. The AI generates code using the variables you defined
6. Paste the code, fill in the values, and run

Workflow C — write the code yourself

If you can write Python, the editor is ready for you. It has autocomplete and syntax checking, so you can skip the external editor. Read field values via inputs["field_name"]:

# inputs["field_name"] reads the value from each field
input_dir = inputs["input_folder"]    # folder field
output_path = inputs["output_file"]   # file field
count = int(inputs["max_count"])      # number — arrives as a string, so convert
is_enabled = inputs["enabled"] == "true"  # checkbox

Not sure what to build? The scripts page has working examples you can use directly or adapt.

Sharing scripts (import / export)

You can save any script as a .pybes file and hand it off. The recipient imports it and gets both the code and the input fields — exactly as you configured them.

Export

1. Right-click a script on the script list
2. Choose Export
3. Save the .pybes file

Import

1. Click Import in the script list toolbar and pick a .pybes file, or drag the file onto the script list
2. If the file is encrypted, enter the password
3. The script is added to your app