From c728cde9cbebd0087746da5245b1038418c3fdff Mon Sep 17 00:00:00 2001
From: Mendon Kissling <59585235+mendonk@users.noreply.github.com>
Date: Wed, 7 Jan 2026 16:02:45 -0500
Subject: [PATCH] docs: pass variable input to python interpreter component
(#11217)
* pass-input-to-repl
* Apply suggestions from code review
Co-authored-by: April I. Murphy <36110273+aimurphy@users.noreply.github.com>
---------
Co-authored-by: April I. Murphy <36110273+aimurphy@users.noreply.github.com>
---
docs/docs/Components/python-interpreter.mdx | 153 ++++++++++++++++++++
1 file changed, 153 insertions(+)
diff --git a/docs/docs/Components/python-interpreter.mdx b/docs/docs/Components/python-interpreter.mdx
index 3cfb5dded0..48d042960a 100644
--- a/docs/docs/Components/python-interpreter.mdx
+++ b/docs/docs/Components/python-interpreter.mdx
@@ -77,6 +77,159 @@ Output:
If you don't include the package imports in the chat, the agent can still create the table using `pd.DataFrame`, because the `pandas` package is imported globally by the **Python Interpreter** component in the **Global Imports** field.
+## Pass inputs to the Python Interpreter
+
+To pass inputs to the **Python Interpreter** component, you need to customize the component's code to add input fields.
+After the input field is added to the component code, the port becomes available for connections.
+For example, to connect a [**Text** component](/text-input-and-output) and pass a URL value to the **Python Interpreter** component, do the following:
+
+1. Add a **Python Interpreter** component to your flow.
+2. To modify the **Python Interpreter** component's code, click **Edit Code**.
+3. To pass a URL input to the **Python Interpreter** component, make the following changes to the code:
+
+ a. Add the URL input field to the `inputs` list. This creates the input port that other components can connect to.
+
+ b. Update the `get_globals` method to extract the URL value and add it to the globals dictionary.
+ This makes the `url` variable available in the component's Python code.
+
+ c. Update the default Python code value to use the `url` variable.
+
+ The following example demonstrates these modifications.
+
+
+ Python code example
+
+ ```python
+ import importlib
+
+ from langchain_experimental.utilities import PythonREPL
+ from lfx.custom.custom_component.component import Component
+ from lfx.io import MultilineInput, Output, StrInput
+ from lfx.schema.data import Data
+ from lfx.schema.message import Message # Needed to extract text from Message objects
+
+ class PythonREPLComponent(Component):
+ display_name = "Python Interpreter"
+ description = "Run Python code with optional imports. Use print() to see the output."
+ documentation: str = "https://docs.langflow.org/python-interpreter"
+ icon = "square-terminal"
+
+ inputs = [
+ StrInput(
+ name="global_imports",
+ display_name="Global Imports",
+ info="A comma-separated list of modules to import globally, e.g. 'math,numpy,pandas'.",
+ value="math,pandas",
+ required=True,
+ ),
+ MultilineInput(
+ name="python_code",
+ display_name="Python Code",
+ info="The Python code to execute. Only modules specified in Global Imports can be used. Use 'url' variable if URL input is connected.",
+ value="print(f'URL: {url}')", # Updated to make the URL variable available to the Python code execution
+ input_types=["Message"],
+ tool_mode=True,
+ required=True,
+ ),
+ # Add the URL input field to inputs list
+ StrInput(
+ name="url",
+ display_name="URL",
+ info="URL variable that can be used in Python code. Connect a Text component or enter manually.",
+ value="",
+ input_types=["Text", "Message"],
+ required=False,
+ ),
+ ]
+
+ outputs = [
+ Output(
+ display_name="Results",
+ name="results",
+ type_=Data,
+ method="run_python_repl",
+ ),
+ ]
+
+ def get_globals(self, global_imports: str | list[str]) -> dict:
+ """Create a globals dictionary with only the specified allowed imports and input variables."""
+ global_dict = {}
+
+ try:
+ if isinstance(global_imports, str):
+ modules = [module.strip() for module in global_imports.split(",")]
+ elif isinstance(global_imports, list):
+ modules = global_imports
+ else:
+ msg = "global_imports must be either a string or a list"
+ raise TypeError(msg)
+
+ for module in modules:
+ try:
+ imported_module = importlib.import_module(module)
+ global_dict[imported_module.__name__] = imported_module
+ except ImportError as e:
+ msg = f"Could not import module {module}: {e!s}"
+ raise ImportError(msg) from e
+
+ # Add the URL variable to the component's globals dictionary
+ # Extract from Message object or use the string directly
+ if hasattr(self, "url") and self.url:
+ url_value = self.url.text if isinstance(self.url, Message) else str(self.url)
+ if url_value:
+ global_dict["url"] = url_value # Makes 'url' available in Python code
+ self.log(f"URL variable set: {url_value}")
+
+ except Exception as e:
+ self.log(f"Error in global imports: {e!s}")
+ raise
+ else:
+ self.log(f"Successfully imported modules: {list(global_dict.keys())}")
+ return global_dict
+
+ def run_python_repl(self) -> Data:
+ try:
+ # Extract Python code text if it's a Message object
+ python_code_text = self.python_code
+ if isinstance(python_code_text, Message):
+ python_code_text = python_code_text.text if python_code_text.text else ""
+ elif not isinstance(python_code_text, str):
+ python_code_text = str(python_code_text)
+
+ globals_ = self.get_globals(self.global_imports)
+ python_repl = PythonREPL(_globals=globals_)
+ result = python_repl.run(python_code_text)
+ result = result.strip() if result else ""
+
+ self.log("Code execution completed successfully")
+ return Data(data={"result": result})
+
+ except ImportError as e:
+ error_message = f"Import Error: {e!s}"
+ self.log(error_message)
+ return Data(data={"error": error_message})
+
+ except SyntaxError as e:
+ error_message = f"Syntax Error: {e!s}"
+ self.log(error_message)
+ return Data(data={"error": error_message})
+
+ except (NameError, TypeError, ValueError) as e:
+ error_message = f"Error during execution: {e!s}"
+ self.log(error_message)
+ return Data(data={"error": error_message})
+
+ def build(self):
+ return self.run_python_repl
+ ```
+
+
+4. To save the modifications, click **Check & Save**.
+5. Add a **Text** component to your flow and set its value, such as `google.com`.
+6. Connect the **Text** component's output to the new **URL** input field on your customized **Python Interpreter** component.
+
+The **Python Interpreter** component can now use the `url` variable in the Python code that it executes.
+
## Python Interpreter parameters
| Name | Type | Description |