Class ExternalPythonExecutionStrategy

java.lang.Object

ai.nervemind.app.executor.script.ExternalPythonExecutionStrategy

All Implemented Interfaces:

ScriptExecutionStrategy

@Component
public class ExternalPythonExecutionStrategy
extends Object
implements ScriptExecutionStrategy

External Python execution strategy using subprocess.

Executes Python code using the user's installed Python interpreter via subprocess. This provides full access to the Python ecosystem including pip-installed packages.

Features

• Full Python standard library access
• pip packages available
• Any Python version supported (3.8+)
• Virtual environment support

Limitations

• Requires Python to be installed
• Slower startup than embedded mode
• Less sandboxed (can access filesystem)

Available Globals

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

Example

import json

# Access input data
items = input.get('items', [])

# Use any Python feature
result = {
    'count': len(items),
    'processed': [x.upper() for x in items]
}
return result

Constructor Summary

Constructors

Constructor	Description
ExternalPythonExecutionStrategy(com.fasterxml.jackson.databind.ObjectMapper objectMapper, SettingsService settingsService)	Creates a new external Python execution strategy.

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

ExternalPythonExecutionStrategy

public ExternalPythonExecutionStrategy(com.fasterxml.jackson.databind.ObjectMapper objectMapper,
 SettingsService settingsService)

Creates a new external Python execution strategy.

Parameters:

objectMapper - the ObjectMapper for JSON serialization/deserialization

settingsService - the settings service for configuration access

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 (e.g., "javascript", "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 (e.g., "JavaScript (GraalJS)", "Python (GraalPy)")

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 the strategy can be used

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:

diagnostic message, or empty string if available