Pre-release

This release is a pre-release and may not be stable for production use.

Union Flyte Plugin

Proprietary extensions and features for Flyte, providing Union-specific functionality.

Installation

uv pip install flyteplugins-union

For development:

uv pip install -e .

Flyte compatibility

flyteplugins-union builds on flyte SDK internals that can change between flyte minor releases, so each release pins flyte to a single minor line. Install a flyteplugins-union release built for your flyte minor:

flyteplugins-union	Requires flyte
0.11.0+	`>=2.6.7,<2.9.0`
0.8.2 – 0.10.9	`>=2.6.7,<2.7.0`
0.8.0 – 0.8.1	`>=2.6.3,<2.7.0`
0.7.2	`>=2.5.20,<2.7.0`
0.5.0 – 0.7.1	`>=2.5.7,<2.6.0`
0.4.3	`>=2.5.0,<2.6.0`
0.4.0 – 0.4.2	`>=2.3.0,<2.5.0`
0.3.0	`>=2.1.0,<2.5.0`

See COMPATIBILITY.md for the rationale and how the pin tracks new flyte releases.

Features

API Key Management

Create and manage API keys for headless authentication with Union.

Create an API Key

flyte create api-key admin --name my-api-key

This will create OAuth application credentials and output an API key that can be used for headless authentication.

Example output:

Client ID: serverless-1-myorg-my-api-key
The following API key will only be shown once. Be sure to keep it safe!
Configure your headless CLI by setting the following environment variable:

export FLYTE_API_KEY="<base64-encoded-credentials>"

Using the API Key

Set the generated API key as an environment variable:

export FLYTE_API_KEY="<your-api-key>"

Then use the Flyte CLI as normal - it will authenticate using the API key instead of prompting for interactive login.

Architecture

The Union SDK is structured as follows:

flyteplugins/union/internal/ - Proprietary protobuf definitions and generated code
flyteplugins/union/cli/ - CLI command plugins that extend the Flyte CLI
flyteplugins/union/utils/ - Shared utility functions
flyteplugins/union/remote/ - Union-specific remote objects

Plugin System

The SDK registers CLI plugins via entry points in pyproject.toml:

[project.entry-points."flyte.plugins.cli.commands"]
"create.api-key" = "flyteplugins.union.cli.api_key:create_api_key"
"delete.api-key" = "flyteplugins.union.cli.api_key:delete_api_key"
"get.api-key" = "flyteplugins.union.cli.api_key:get_api_key"

This makes Union commands available seamlessly through the Flyte CLI.

Dependencies

flyte - The Flyte SDK v2 (pinned to a single minor; see Flyte compatibility)
rich-click>=1.8.0 - For CLI formatting

Development

To add a new CLI plugin:

Create a new file in src/flyteplugins/union/cli/
Define your click commands
Register the entry point in pyproject.toml
Shared resources (protobufs, utilities) are available in flyteplugins.union.internal.* and flyteplugins.union.utils.*

Iterating

Commands to rebuild and reinstall this plugin (into the flyte-sdk venv presumably). From this folder:

python -m build --wheel

From your flyte-sdk venv:

uv pip install --prerelease=allow --force-reinstall --no-deps --no-index --find-links /Users/ytong/go/src/github.com/unionai/flyteplugins-union/dist flyteplugins-union

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

flyteplugins_union-0.11.0b1.tar.gz (330.7 kB view details)

Uploaded Sep 17, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

flyteplugins_union-0.11.0b1-py3-none-win_amd64.whl (34.8 MB view details)

Uploaded Sep 17, 2026 Python 3Windows x86-64

flyteplugins_union-0.11.0b1-py3-none-manylinux2014_x86_64.whl (21.7 MB view details)

Uploaded Sep 17, 2026 Python 3

flyteplugins_union-0.11.0b1-py3-none-manylinux2014_aarch64.whl (19.3 MB view details)

Uploaded Sep 17, 2026 Python 3

flyteplugins_union-0.11.0b1-py3-none-macosx_11_0_arm64.whl (34.2 MB view details)

Uploaded Sep 17, 2026 Python 3macOS 11.0+ ARM64

flyteplugins_union-0.11.0b1-py3-none-macosx_10_15_x86_64.whl (36.1 MB view details)

Uploaded Sep 17, 2026 Python 3macOS 10.15+ x86-64

File details

Details for the file flyteplugins_union-0.11.0b1.tar.gz.

File metadata

Download URL: flyteplugins_union-0.11.0b1.tar.gz
Upload date: Sep 17, 2026
Size: 330.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for flyteplugins_union-0.11.0b1.tar.gz
Algorithm	Hash digest
SHA256	`36e68412c4582c4b7a1db14defa80bbb7afd94fc6a9228451872e78df15675c1`
MD5	`bacf60fb05fd6909ea7b7186bb07afa0`
BLAKE2b-256	`55d693d698ed90d46dc30cffee16a3710e33221156752443d56ff1a80df47931`

See more details on using hashes here.

File details

Details for the file flyteplugins_union-0.11.0b1-py3-none-win_amd64.whl.

File metadata

Download URL: flyteplugins_union-0.11.0b1-py3-none-win_amd64.whl
Upload date: Sep 17, 2026
Size: 34.8 MB
Tags: Python 3, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for flyteplugins_union-0.11.0b1-py3-none-win_amd64.whl
Algorithm	Hash digest
SHA256	`9f78bfb1a9700acc268825e63d2df6a4bc95b314412e1835b87842d6c95a2867`
MD5	`8f4eaf470273bbed0c805e765bfafb08`
BLAKE2b-256	`63534006ac54afd27108f9db11cd0740a27d5f8fcba04d3fefc6b73937cf31bd`

See more details on using hashes here.

File details

Details for the file flyteplugins_union-0.11.0b1-py3-none-manylinux2014_x86_64.whl.

File metadata

Download URL: flyteplugins_union-0.11.0b1-py3-none-manylinux2014_x86_64.whl
Upload date: Sep 17, 2026
Size: 21.7 MB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for flyteplugins_union-0.11.0b1-py3-none-manylinux2014_x86_64.whl
Algorithm	Hash digest
SHA256	`e1f6dbc88d2a92487550fdad47200edc0682e699809b642ebe1305a5c17c7e05`
MD5	`6d8625b6ccd4e10c9aab5e97b60a21fe`
BLAKE2b-256	`407ca0cdd124b8421bbe4f6c738af88e075f385f5b08077289efb4da143187c7`

See more details on using hashes here.

File details

Details for the file flyteplugins_union-0.11.0b1-py3-none-manylinux2014_aarch64.whl.

File metadata

Download URL: flyteplugins_union-0.11.0b1-py3-none-manylinux2014_aarch64.whl
Upload date: Sep 17, 2026
Size: 19.3 MB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for flyteplugins_union-0.11.0b1-py3-none-manylinux2014_aarch64.whl
Algorithm	Hash digest
SHA256	`25e4d03f17055bf1915911edcf678046585bb25cb9f4ba579f2b41b57f6efb5e`
MD5	`5b7d94c60a2a9370b92416f4d331133e`
BLAKE2b-256	`8505c58aea21ca2cec0407f62ddfac2559b1ac5585334f40e97433ed6b5cdb0b`

See more details on using hashes here.

File details

Details for the file flyteplugins_union-0.11.0b1-py3-none-macosx_11_0_arm64.whl.

File metadata

Download URL: flyteplugins_union-0.11.0b1-py3-none-macosx_11_0_arm64.whl
Upload date: Sep 17, 2026
Size: 34.2 MB
Tags: Python 3, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for flyteplugins_union-0.11.0b1-py3-none-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`0c593e21f64d3aec72a22d14423f02c06000437ea51dcfe1b57d1448db5f1e5a`
MD5	`1ca475668a9c3db07a49d8a5cc7b5a93`
BLAKE2b-256	`a7d444e6ca52b54fd9d3e366a3abf1cb5747292df3824edba3fcc09235e94d4b`

See more details on using hashes here.

File details

Details for the file flyteplugins_union-0.11.0b1-py3-none-macosx_10_15_x86_64.whl.

File metadata

Download URL: flyteplugins_union-0.11.0b1-py3-none-macosx_10_15_x86_64.whl
Upload date: Sep 17, 2026
Size: 36.1 MB
Tags: Python 3, macOS 10.15+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for flyteplugins_union-0.11.0b1-py3-none-macosx_10_15_x86_64.whl
Algorithm	Hash digest
SHA256	`e2ffaed3a98d900d5a26ee2965f2f54401c22a06f1c48e12e508f8dcf8f81284`
MD5	`f0106bb3fd9c8cd9c212e8f192559861`
BLAKE2b-256	`804e5fa59eebbfc108391f6fcbf564bc659b2279823580ed1f1c1c95e61d098a`