vellum-ai 0.9.16__py3-none-any.whl → 0.9.16rc4__py3-none-any.whl

vellum/types/workflow_request_chat_history_input_request.py

@@ -1,30 +1,3 @@
-# This file was auto-generated by Fern from our API Definition.
+# WARNING: This file will be removed in a future release. Please import from "vellum.client" instead.
 
-from ..core.pydantic_utilities import UniversalBaseModel
-import pydantic
-import typing
-from .chat_message_request import ChatMessageRequest
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
-
-
-class WorkflowRequestChatHistoryInputRequest(UniversalBaseModel):
-    """
-    The input for a chat history variable in a Workflow.
-    """
-
-    name: str = pydantic.Field()
-    """
-    The variable's name, as defined in the Workflow.
-    """
-
-    type: typing.Literal["CHAT_HISTORY"] = "CHAT_HISTORY"
-    value: typing.List[ChatMessageRequest]
-
-    if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
-    else:
-
-        class Config:
-            frozen = True
-            smart_union = True
-            extra = pydantic.Extra.allow
+from vellum.client.types.workflow_request_chat_history_input_request import *

vellum/types/workflow_request_input_request.py

@@ -1,14 +1,3 @@
-# This file was auto-generated by Fern from our API Definition.
+# WARNING: This file will be removed in a future release. Please import from "vellum.client" instead.
 
-import typing
-from .workflow_request_string_input_request import WorkflowRequestStringInputRequest
-from .workflow_request_json_input_request import WorkflowRequestJsonInputRequest
-from .workflow_request_chat_history_input_request import WorkflowRequestChatHistoryInputRequest
-from .workflow_request_number_input_request import WorkflowRequestNumberInputRequest
-
-WorkflowRequestInputRequest = typing.Union[
-    WorkflowRequestStringInputRequest,
-    WorkflowRequestJsonInputRequest,
-    WorkflowRequestChatHistoryInputRequest,
-    WorkflowRequestNumberInputRequest,
-]
+from vellum.client.types.workflow_request_input_request import *

vellum/types/workflow_request_json_input_request.py

@@ -1,29 +1,3 @@
-# This file was auto-generated by Fern from our API Definition.
+# WARNING: This file will be removed in a future release. Please import from "vellum.client" instead.
 
-from ..core.pydantic_utilities import UniversalBaseModel
-import pydantic
-import typing
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
-
-
-class WorkflowRequestJsonInputRequest(UniversalBaseModel):
-    """
-    The input for a JSON variable in a Workflow.
-    """
-
-    name: str = pydantic.Field()
-    """
-    The variable's name, as defined in the Workflow.
-    """
-
-    type: typing.Literal["JSON"] = "JSON"
-    value: typing.Optional[typing.Any] = None
-
-    if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
-    else:
-
-        class Config:
-            frozen = True
-            smart_union = True
-            extra = pydantic.Extra.allow
+from vellum.client.types.workflow_request_json_input_request import *

vellum/types/workflow_request_number_input_request.py

@@ -1,29 +1,3 @@
-# This file was auto-generated by Fern from our API Definition.
+# WARNING: This file will be removed in a future release. Please import from "vellum.client" instead.
 
-from ..core.pydantic_utilities import UniversalBaseModel
-import pydantic
-import typing
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
-
-
-class WorkflowRequestNumberInputRequest(UniversalBaseModel):
-    """
-    The input for a number variable in a Workflow.
-    """
-
-    name: str = pydantic.Field()
-    """
-    The variable's name, as defined in the Workflow.
-    """
-
-    type: typing.Literal["NUMBER"] = "NUMBER"
-    value: float
-
-    if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
-    else:
-
-        class Config:
-            frozen = True
-            smart_union = True
-            extra = pydantic.Extra.allow
+from vellum.client.types.workflow_request_number_input_request import *

vellum/types/workflow_request_string_input_request.py

@@ -1,29 +1,3 @@
-# This file was auto-generated by Fern from our API Definition.
+# WARNING: This file will be removed in a future release. Please import from "vellum.client" instead.
 
-from ..core.pydantic_utilities import UniversalBaseModel
-import pydantic
-import typing
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
-
-
-class WorkflowRequestStringInputRequest(UniversalBaseModel):
-    """
-    The input for a string variable in a Workflow.
-    """
-
-    name: str = pydantic.Field()
-    """
-    The variable's name, as defined in the Workflow.
-    """
-
-    type: typing.Literal["STRING"] = "STRING"
-    value: str
-
-    if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
-    else:
-
-        class Config:
-            frozen = True
-            smart_union = True
-            extra = pydantic.Extra.allow
+from vellum.client.types.workflow_request_string_input_request import *

vellum/types/workflow_result_event.py

@@ -1,39 +1,3 @@
-# This file was auto-generated by Fern from our API Definition.
+# WARNING: This file will be removed in a future release. Please import from "vellum.client" instead.
 
-from __future__ import annotations
-from ..core.pydantic_utilities import UniversalBaseModel
-from .array_variable_value import ArrayVariableValue
-from .array_vellum_value import ArrayVellumValue
-from .workflow_node_result_event_state import WorkflowNodeResultEventState
-import datetime as dt
-import typing
-from .workflow_result_event_output_data import WorkflowResultEventOutputData
-from .workflow_event_error import WorkflowEventError
-from .workflow_output import WorkflowOutput
-from .execution_vellum_value import ExecutionVellumValue
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
-import pydantic
-from ..core.pydantic_utilities import update_forward_refs
-
-
-class WorkflowResultEvent(UniversalBaseModel):
-    id: str
-    state: WorkflowNodeResultEventState
-    ts: dt.datetime
-    output: typing.Optional[WorkflowResultEventOutputData] = None
-    error: typing.Optional[WorkflowEventError] = None
-    outputs: typing.Optional[typing.List[WorkflowOutput]] = None
-    inputs: typing.Optional[typing.List[ExecutionVellumValue]] = None
-
-    if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
-    else:
-
-        class Config:
-            frozen = True
-            smart_union = True
-            extra = pydantic.Extra.allow
-
-
-update_forward_refs(ArrayVariableValue, WorkflowResultEvent=WorkflowResultEvent)
-update_forward_refs(ArrayVellumValue, WorkflowResultEvent=WorkflowResultEvent)
+from vellum.client.types.workflow_result_event import *

vellum/types/workflow_result_event_output_data.py

@@ -1,22 +1,3 @@
-# This file was auto-generated by Fern from our API Definition.
+# WARNING: This file will be removed in a future release. Please import from "vellum.client" instead.
 
-import typing
-from .workflow_result_event_output_data_string import WorkflowResultEventOutputDataString
-from .workflow_result_event_output_data_number import WorkflowResultEventOutputDataNumber
-from .workflow_result_event_output_data_json import WorkflowResultEventOutputDataJson
-from .workflow_result_event_output_data_chat_history import WorkflowResultEventOutputDataChatHistory
-from .workflow_result_event_output_data_search_results import WorkflowResultEventOutputDataSearchResults
-from .workflow_result_event_output_data_array import WorkflowResultEventOutputDataArray
-from .workflow_result_event_output_data_function_call import WorkflowResultEventOutputDataFunctionCall
-from .workflow_result_event_output_data_error import WorkflowResultEventOutputDataError
-
-WorkflowResultEventOutputData = typing.Union[
-    WorkflowResultEventOutputDataString,
-    WorkflowResultEventOutputDataNumber,
-    WorkflowResultEventOutputDataJson,
-    WorkflowResultEventOutputDataChatHistory,
-    WorkflowResultEventOutputDataSearchResults,
-    WorkflowResultEventOutputDataArray,
-    WorkflowResultEventOutputDataFunctionCall,
-    WorkflowResultEventOutputDataError,
-]
+from vellum.client.types.workflow_result_event_output_data import *

vellum/types/workflow_result_event_output_data_array.py

@@ -1,41 +1,3 @@
-# This file was auto-generated by Fern from our API Definition.
+# WARNING: This file will be removed in a future release. Please import from "vellum.client" instead.
 
-from __future__ import annotations
-from ..core.pydantic_utilities import UniversalBaseModel
-from .array_variable_value import ArrayVariableValue
-import typing
-from .workflow_node_result_event_state import WorkflowNodeResultEventState
-import pydantic
-from .array_variable_value_item import ArrayVariableValueItem
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
-from ..core.pydantic_utilities import update_forward_refs
-
-
-class WorkflowResultEventOutputDataArray(UniversalBaseModel):
-    """
-    An Array output returned from a Workflow execution.
-    """
-
-    id: typing.Optional[str] = None
-    name: str
-    state: WorkflowNodeResultEventState
-    node_id: str
-    delta: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    The newly output string value. Only relevant for string outputs with a state of STREAMING.
-    """
-
-    type: typing.Literal["ARRAY"] = "ARRAY"
-    value: typing.Optional[typing.List[ArrayVariableValueItem]] = None
-
-    if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
-    else:
-
-        class Config:
-            frozen = True
-            smart_union = True
-            extra = pydantic.Extra.allow
-
-
-update_forward_refs(ArrayVariableValue, WorkflowResultEventOutputDataArray=WorkflowResultEventOutputDataArray)
+from vellum.client.types.workflow_result_event_output_data_array import *

vellum/types/workflow_result_event_output_data_chat_history.py

@@ -1,35 +1,3 @@
-# This file was auto-generated by Fern from our API Definition.
+# WARNING: This file will be removed in a future release. Please import from "vellum.client" instead.
 
-from ..core.pydantic_utilities import UniversalBaseModel
-import typing
-from .workflow_node_result_event_state import WorkflowNodeResultEventState
-import pydantic
-from .chat_message import ChatMessage
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
-
-
-class WorkflowResultEventOutputDataChatHistory(UniversalBaseModel):
-    """
-    A Chat History output streamed from a Workflow execution.
-    """
-
-    id: typing.Optional[str] = None
-    name: str
-    state: WorkflowNodeResultEventState
-    node_id: str
-    delta: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    The newly output string value. Only relevant for string outputs with a state of STREAMING.
-    """
-
-    type: typing.Literal["CHAT_HISTORY"] = "CHAT_HISTORY"
-    value: typing.Optional[typing.List[ChatMessage]] = None
-
-    if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
-    else:
-
-        class Config:
-            frozen = True
-            smart_union = True
-            extra = pydantic.Extra.allow
+from vellum.client.types.workflow_result_event_output_data_chat_history import *

vellum/types/workflow_result_event_output_data_error.py

@@ -1,35 +1,3 @@
-# This file was auto-generated by Fern from our API Definition.
+# WARNING: This file will be removed in a future release. Please import from "vellum.client" instead.
 
-from ..core.pydantic_utilities import UniversalBaseModel
-import typing
-from .workflow_node_result_event_state import WorkflowNodeResultEventState
-import pydantic
-from .vellum_error import VellumError
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
-
-
-class WorkflowResultEventOutputDataError(UniversalBaseModel):
-    """
-    An Error output streamed from a Workflow execution.
-    """
-
-    id: typing.Optional[str] = None
-    name: str
-    state: WorkflowNodeResultEventState
-    node_id: str
-    delta: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    The newly output string value. Only relevant for string outputs with a state of STREAMING.
-    """
-
-    type: typing.Literal["ERROR"] = "ERROR"
-    value: typing.Optional[VellumError] = None
-
-    if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
-    else:
-
-        class Config:
-            frozen = True
-            smart_union = True
-            extra = pydantic.Extra.allow
+from vellum.client.types.workflow_result_event_output_data_error import *

vellum/types/workflow_result_event_output_data_function_call.py

@@ -1,35 +1,3 @@
-# This file was auto-generated by Fern from our API Definition.
+# WARNING: This file will be removed in a future release. Please import from "vellum.client" instead.
 
-from ..core.pydantic_utilities import UniversalBaseModel
-import typing
-from .workflow_node_result_event_state import WorkflowNodeResultEventState
-import pydantic
-from .function_call import FunctionCall
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
-
-
-class WorkflowResultEventOutputDataFunctionCall(UniversalBaseModel):
-    """
-    A Function Call output returned from a Workflow execution.
-    """
-
-    id: typing.Optional[str] = None
-    name: str
-    state: WorkflowNodeResultEventState
-    node_id: str
-    delta: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    The newly output string value. Only relevant for string outputs with a state of STREAMING.
-    """
-
-    type: typing.Literal["FUNCTION_CALL"] = "FUNCTION_CALL"
-    value: typing.Optional[FunctionCall] = None
-
-    if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
-    else:
-
-        class Config:
-            frozen = True
-            smart_union = True
-            extra = pydantic.Extra.allow
+from vellum.client.types.workflow_result_event_output_data_function_call import *

vellum/types/workflow_result_event_output_data_json.py

@@ -1,34 +1,3 @@
-# This file was auto-generated by Fern from our API Definition.
+# WARNING: This file will be removed in a future release. Please import from "vellum.client" instead.
 
-from ..core.pydantic_utilities import UniversalBaseModel
-import typing
-from .workflow_node_result_event_state import WorkflowNodeResultEventState
-import pydantic
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
-
-
-class WorkflowResultEventOutputDataJson(UniversalBaseModel):
-    """
-    A JSON output streamed from a Workflow execution.
-    """
-
-    id: typing.Optional[str] = None
-    name: str
-    state: WorkflowNodeResultEventState
-    node_id: str
-    delta: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    The newly output string value. Only relevant for string outputs with a state of STREAMING.
-    """
-
-    type: typing.Literal["JSON"] = "JSON"
-    value: typing.Optional[typing.Any] = None
-
-    if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
-    else:
-
-        class Config:
-            frozen = True
-            smart_union = True
-            extra = pydantic.Extra.allow
+from vellum.client.types.workflow_result_event_output_data_json import *

vellum/types/workflow_result_event_output_data_number.py

@@ -1,34 +1,3 @@
-# This file was auto-generated by Fern from our API Definition.
+# WARNING: This file will be removed in a future release. Please import from "vellum.client" instead.
 
-from ..core.pydantic_utilities import UniversalBaseModel
-import typing
-from .workflow_node_result_event_state import WorkflowNodeResultEventState
-import pydantic
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
-
-
-class WorkflowResultEventOutputDataNumber(UniversalBaseModel):
-    """
-    A number output streamed from a Workflow execution.
-    """
-
-    id: typing.Optional[str] = None
-    name: str
-    state: WorkflowNodeResultEventState
-    node_id: str
-    delta: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    The newly output string value. Only relevant for string outputs with a state of STREAMING.
-    """
-
-    type: typing.Literal["NUMBER"] = "NUMBER"
-    value: typing.Optional[float] = None
-
-    if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
-    else:
-
-        class Config:
-            frozen = True
-            smart_union = True
-            extra = pydantic.Extra.allow
+from vellum.client.types.workflow_result_event_output_data_number import *

vellum/types/workflow_result_event_output_data_search_results.py

@@ -1,35 +1,3 @@
-# This file was auto-generated by Fern from our API Definition.
+# WARNING: This file will be removed in a future release. Please import from "vellum.client" instead.
 
-from ..core.pydantic_utilities import UniversalBaseModel
-import typing
-from .workflow_node_result_event_state import WorkflowNodeResultEventState
-import pydantic
-from .search_result import SearchResult
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
-
-
-class WorkflowResultEventOutputDataSearchResults(UniversalBaseModel):
-    """
-    A Search Results output streamed from a Workflow execution.
-    """
-
-    id: typing.Optional[str] = None
-    name: str
-    state: WorkflowNodeResultEventState
-    node_id: str
-    delta: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    The newly output string value. Only relevant for string outputs with a state of STREAMING.
-    """
-
-    type: typing.Literal["SEARCH_RESULTS"] = "SEARCH_RESULTS"
-    value: typing.Optional[typing.List[SearchResult]] = None
-
-    if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
-    else:
-
-        class Config:
-            frozen = True
-            smart_union = True
-            extra = pydantic.Extra.allow
+from vellum.client.types.workflow_result_event_output_data_search_results import *

vellum/types/workflow_result_event_output_data_string.py

@@ -1,37 +1,3 @@
-# This file was auto-generated by Fern from our API Definition.
+# WARNING: This file will be removed in a future release. Please import from "vellum.client" instead.
 
-from ..core.pydantic_utilities import UniversalBaseModel
-import typing
-from .workflow_node_result_event_state import WorkflowNodeResultEventState
-import pydantic
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
-
-
-class WorkflowResultEventOutputDataString(UniversalBaseModel):
-    """
-    A string output streamed from a Workflow execution.
-    """
-
-    id: typing.Optional[str] = None
-    name: str
-    state: WorkflowNodeResultEventState
-    node_id: str
-    delta: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    The newly output string value, meant to be concatenated with all previous. Will be non-null for events of state STREAMING.
-    """
-
-    type: typing.Literal["STRING"] = "STRING"
-    value: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    The entire string value. Will be non-null for events of state FULFILLED.
-    """
-
-    if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
-    else:
-
-        class Config:
-            frozen = True
-            smart_union = True
-            extra = pydantic.Extra.allow
+from vellum.client.types.workflow_result_event_output_data_string import *

vellum/types/workflow_stream_event.py

@@ -1,7 +1,3 @@
-# This file was auto-generated by Fern from our API Definition.
+# WARNING: This file will be removed in a future release. Please import from "vellum.client" instead.
 
-import typing
-from .workflow_execution_workflow_result_event import WorkflowExecutionWorkflowResultEvent
-from .workflow_execution_node_result_event import WorkflowExecutionNodeResultEvent
-
-WorkflowStreamEvent = typing.Union[WorkflowExecutionWorkflowResultEvent, WorkflowExecutionNodeResultEvent]
+from vellum.client.types.workflow_stream_event import *

vellum/types/workspace_secret_read.py

@@ -1,25 +1,3 @@
-# This file was auto-generated by Fern from our API Definition.
+# WARNING: This file will be removed in a future release. Please import from "vellum.client" instead.
 
-from ..core.pydantic_utilities import UniversalBaseModel
-import datetime as dt
-from .secret_type_enum import SecretTypeEnum
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
-import typing
-import pydantic
-
-
-class WorkspaceSecretRead(UniversalBaseModel):
-    id: str
-    modified: dt.datetime
-    name: str
-    label: str
-    secret_type: SecretTypeEnum
-
-    if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
-    else:
-
-        class Config:
-            frozen = True
-            smart_union = True
-            extra = pydantic.Extra.allow
+from vellum.client.types.workspace_secret_read import *

vellum/workflows/README.md

@@ -0,0 +1,90 @@
+<p align="center">
+  <h1 align="center">
+  Vellum Workflows SDK
+  </h1>
+  <p align="center">
+    <a href="https://docs.vellum.ai/developers/workflows-sdk">Learn more</a>
+    ·
+    <a href="https://www.vellum.ai/landing-pages/request-demo">Talk to us</a>
+  </p>
+</p>
+
+# Introduction
+
+The Vellum Workflows SDK is a framework for defining and executing complex AI systems as graphs.
+
+The Vellum Workflows SDK provides a declarative python syntax for both defining and executing the control flow of graphs.
+Unlike other graph execution frameworks, which are functional or event-driven in nature, Vellum's Workflows SDK defines the control flow of a graph
+statically and makes use of strict typing. This means that the structure of the graph is known ahead of time, and you get all the benefits of type
+safety and intellisense. This ultimately makes it easier to build more predictable and robust AI systems.
+
+Unique amongst other frameworks, Vellum's Workflows SDK also allows you to _visualize, edit, and execute_ your graph in a UI, pushing and pulling changes from
+code to UI and vice versa.
+
+
+## Core Features
+- **Nodes**: Nodes are the basic building blocks of a graph. They represent a single task or function that can be executed.
+- **Graph Syntax**: An intuitive declarative syntax for defining the control flow of a graph.
+- **Inputs and Outputs**: Both the Workflow itslef and individual Nodes can take in inputs and produce outputs, which can be used to pass information between nodes.
+- **State**: Nodes can read and write to the graph's global state, which can be used to share information between nodes without defining explicit inputs and outputs.
+- **Advanced Control Flow**: Support for looping, conditionals, paralellism, state forking, and more.
+- **Streaming**: Nodes can stream output values back to the runner, allowing for long-running tasks like chat completions to return partial results.
+- **Human-in-the-loop**: Nodes can wait for External Inputs, allowing for a pause in the Workflow until a human or external system provides input.
+- **UI Integration**: Push and pull changes from code to Vellum's UI and vice versa, allowing for rapid testing and iteration.
+
+## Quickstart
+
+1. Install the Vellum Workflows SDK:
+
+    ```bash
+    pip install vellum-ai
+    ```
+
+2. Import the Vellum Workflows SDK and define your first Workflow:
+
+    ```python
+    # my_workflow.py
+
+    from workflows import BaseWorkflow
+    from workflows.nodes import BaseNode
+
+
+    class MyNode(BaseNode):
+
+        class Outputs(BaseNode.Outputs):
+            result: str
+
+        def run(self):
+            return self.Outputs(result="Hello, World!")
+
+
+    class MyWorkflow(BaseWorkflow):
+        graph = MyNode
+
+        class Outputs(BaseWorkflow.Outputs):
+            result = MyNode.Outputs.result
+
+
+    if __name__ == "__main__":
+        workflow = MyWorkflow()
+        result = workflow.run()
+
+        print(result.outputs.result)
+
+    ```
+3. Run it!
+
+    ```bash
+    python my_workflow.py
+
+Note: To use most out-of-box Nodes, and to push/pull to/from the Velłum UI, you'll need a Vellum account and API key. [Talk to us](https://www.vellum.ai/landing-pages/request-demo) or visit our [pricing page](https://www.vellum.ai/pricing) for more information.
+
+
+## Documentation
+Complete documentation for the Vellum Workflows SDK can be found at https://docs.vellum.ai/developers/workflows-sdk.
+
+
+## Stability
+
+This SDK is currently in <Availability type="beta" /> and is subject to change. If you'd like to pariticpate in
+our beta program, please [contact us](https://docs.vellum.ai/home/getting-started/support).