Class EmbeddedPythonExecutionStrategy

java.lang.Object

ai.nervemind.app.executor.script.EmbeddedPythonExecutionStrategy

All Implemented Interfaces:

ScriptExecutionStrategy

@Component
public class EmbeddedPythonExecutionStrategy
extends Object
implements ScriptExecutionStrategy

Embedded Python execution strategy using GraalPy.

Executes Python code using GraalVM's Python implementation (GraalPy). This provides zero-install Python execution with a sandboxed environment.

Features

• No Python installation required
• Sandboxed execution (no file system or network access by default)
• Fast startup compared to subprocess
• Access to Python standard library subset

Limitations

• Not all Python packages available (no pip)
• Some C extension modules not supported
• Slight compatibility differences from CPython

Available Globals

• input / $input - Data from previous nodes (dict)
• node / $node - Current node parameters (dict)

Example

# Transform input data
items = input.get('items', [])
result = {
    'count': len(items),
    'processed': [x.upper() for x in items]
}
return result

Constructor Summary

Constructors

Constructor	Description
EmbeddedPythonExecutionStrategy()	Default constructor for EmbeddedPythonExecutionStrategy.

Method Summary

Modifier and Type	Method	Description
Map<String,Object>	execute(String code, Map<String,Object> input, ai.nervemind.common.domain.Node node, ExecutionService.ExecutionContext context)	Execute a script with the given input data.
String	getAvailabilityInfo()	Get information about why this strategy might not be available.
String	getDisplayName()	Get a human-readable name for display.
String	getLanguageId()	Get the language identifier this strategy handles.
boolean	isAvailable()	Check if this strategy is available (dependencies installed, etc.).

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

EmbeddedPythonExecutionStrategy

public EmbeddedPythonExecutionStrategy()

Default constructor for EmbeddedPythonExecutionStrategy.

Method Details

execute

public Map<String,Object> execute(String code,
 Map<String,Object> input,
 ai.nervemind.common.domain.Node node,
 ExecutionService.ExecutionContext context)
                           throws ScriptExecutionException

Description copied from interface: ScriptExecutionStrategy

Execute a script with the given input data.

Specified by:

execute in interface ScriptExecutionStrategy

Parameters:

code - the script code to execute

input - input data from previous nodes

node - the node being executed (for accessing parameters)

context - the execution context

Returns:

output data including script results merged with input

Throws:

ScriptExecutionException - if execution fails

getLanguageId

public String getLanguageId()

Description copied from interface: ScriptExecutionStrategy

Get the language identifier this strategy handles.

Specified by:

getLanguageId in interface ScriptExecutionStrategy

Returns:

the language ID ("python")

getDisplayName

public String getDisplayName()

Description copied from interface: ScriptExecutionStrategy

Get a human-readable name for display.

Specified by:

getDisplayName in interface ScriptExecutionStrategy

Returns:

display name with GraalPy mention

isAvailable

public boolean isAvailable()

Description copied from interface: ScriptExecutionStrategy

Check if this strategy is available (dependencies installed, etc.).

Specified by:

isAvailable in interface ScriptExecutionStrategy

Returns:

true if GraalPy runtime is available

getAvailabilityInfo

public String getAvailabilityInfo()

Description copied from interface: ScriptExecutionStrategy

Get information about why this strategy might not be available.

Specified by:

getAvailabilityInfo in interface ScriptExecutionStrategy

Returns:

details about GraalPy version or error message