Overview

Custom Function Repo node lets you run custom python code from a specific Git repository to process or modify frames, and extract or add metadata to frames.

Inputs & Outputs

Inputs : 1, Media Format : Raw Video
Outputs : 1, Media Format: Raw Video
Output Metadata : See below.

Pipeline usage

Use this node when reusable custom logic is maintained as an installable Python package in Git. The repository must contain package_name.module_name, and the selected function (default process_frame) must accept frame plus keyword arguments and return whether the frame should continue downstream. The node parses configuration once as JSON and passes the resulting object as the configuration keyword argument on every frame. Pin git_version and package_version for repeatable deployments, use a read-only token for private repositories, and avoid logging the token. Installation/import errors occur when the deployment first runs, so validate the package and function contract before relying on it in production.

Properties

Property	Description	Type	Default	Required
`git_repo_url`	The URL of the Git repository where the custom code package is located. See example here.	`string`	—	Yes
`git_version`	Git version to use. Can be a branch name, a tag, or a commit hash. Optional.	`string`	—	No
`git_token`	Read-only token to use for private Git repositories.	`string`	—	No
`package_name`	Name of the package to install from the Git repository.	`string`	`null`	Yes
`package_version`	Python package version to install from the Git repository.	`string`	`null`	Yes
`module_name`	Name of the Python module to use from the package.	`string`	`null`	Yes
`function_name`	Name of the function to use from the module. Defaults to `process_frame` if not specified.	`string`	`null`	No
`configuration`	JSON object containing the configuration for the function.	`string`	`{}`	No

Output Metadata

Output metadata is defined by the custom Python code. The example shows a representative custom field; actual keys and values depend on the function implementation.

Path	Type	Description
`custom_metadata_key`	`string`	Value of custom metadata key.

JSON example

{
  "custom_metadata_key": "value"
}