Skip to content

python.md

Latest commit

 

History

History
executable file
·
89 lines (68 loc) · 2.63 KB

python.md

File metadata and controls

executable file
·
89 lines (68 loc) · 2.63 KB

Python Node

The Python node is used to execute Python scripts or inline code within workflows, implementing custom data processing, API calls, file operations, and other logic. Scripts are executed in the shared code_workspace/ directory and can access workflow context data.

Configuration

Field Type Required Default Description
interpreter string No Current Python Python interpreter path
args list[str] No [] Startup arguments appended to the interpreter
env dict[str, str] No {} Additional environment variables, overrides system defaults
timeout_seconds int No 60 Script execution timeout (seconds)
encoding string No utf-8 Encoding for parsing stdout/stderr

Core Concepts

Code Workspace

Python scripts are executed within the code_workspace/ directory:

  • Scripts can read and write files in this directory
  • Multiple Python nodes share the same workspace
  • The workspace persists for the duration of a single workflow execution

Input/Output

  • Input: Outputs from upstream nodes are passed as environment variables or standard input
  • Output: The script's stdout output will be passed as a Message to downstream nodes

When to Use

  • Data processing: Parse JSON/XML, data transformation, formatting
  • API calls: Call third-party services, fetch external data
  • File operations: Read/write files, generate reports
  • Complex calculations: Mathematical operations, algorithm implementations
  • Glue logic: Custom logic connecting different nodes

Examples

Basic Configuration

nodes:
  - id: Data Processor
    type: python
    config:
      timeout_seconds: 120
      env:
        key: value

Specifying Interpreter and Arguments

nodes:
  - id: Script Runner
    type: python
    config:
      interpreter: /usr/bin/python3.11
      timeout_seconds: 300
      encoding: utf-8

Typical Workflow Example

nodes:
  - id: LLM Generator
    type: agent
    config:
      provider: openai
      name: gpt-4o
      api_key: ${API_KEY}
      role: You need to generate executable Python code based on user input. The code should be wrapped in ```python ```.

  - id: Result Parser
    type: python
    config:
      timeout_seconds: 30

edges:
  - from: LLM Generator
    to: Result Parser

Notes

  • Ensure script files are placed in the code_workspace/ directory
  • Long-running scripts should have an appropriately increased timeout_seconds
  • Use env to pass additional environment variables, accessible in scripts via os.getenv