Troubleshoot

💻 Script-Level Debugging (>_ Terminal)

Every script you run provides a live terminal output tab (>_) to help you debug what's going wrong.

How to Use the >_ Terminal Tab

• ✅ Real-time logs show print() output, errors, and any runtime feedback.

• ❌ Syntax or import errors are captured here immediately.

• 🧠 Tip: Add print(variable) at key points to understand your script's behaviour.

• 🪵 Logs are ephemeral and cleared when you close or re-run a script.

Example error message:

Traceback (most recent call last):
  File "main.py", line 14, in <module>
    do_something()
NameError: name 'do_something' is not defined

→ This means do_something() was used but not declared. Check for typos or missing imports.

---

⚠️ Common Config Errors (YAML)

Misformatted YAML is one of the most common reasons scripts fail to load.

Key Points to Check:

• Only one inputs: key at the top level. Define all input fields under this single array.

❌ Incorrect:

inputs:
  - id: foo
inputs:
  - id: bar

✅ Correct:

inputs:
  - id: foo
  - id: bar

• Correct indentation is crucial. YAML is space-sensitive and breaks easily with tabs or misaligned lines.

• Short strings can be written in quotation marks:

script_description: "Merge multiple Excel invoice files"

• Long strings should be broken up using block syntax:

script_description: |
  Automatically merge multiple Excel invoice files 
  into a single consolidated report, summarising totals 
  and highlighting discrepancies.

• Dependencies must be explicitly listed in theyaml. Missing dependencies will crash the script.

pandas==2.3.4
openpyxl

• Incorrect versions can cause bugs. Always specify known-working versions.

---

⚙️ Global System Troubleshooting

In the top-right corner, the Settings drawer (⋮ > Settings) offers global tools that affect all scripts and users on your account.

Key Tools in Settings

• 🧹 Clear Cache Unloads unused Python environments and dependencies. Useful if things break after changing the yaml.

• 📦 System Update Ensures you're running the latest version of the platform. Fixes bugs, improves performance, and adds new features.

• 📧 Change Email Updates your sign-in address. We'll send a verification link.

• 🔥 Delete Account DANGER ZONE: This is permanent. Your scripts and history will be gone forever.

---

🙋‍♂️ Still stuck?

• 📖 Documentation

• 🌐 Website

• 📬 Email: [e-mail]