Skip to main content

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.8.2+ >=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:

  1. Create a new file in src/flyteplugins/union/cli/
  2. Define your click commands
  3. Register the entry point in pyproject.toml
  4. 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.10.3.tar.gz (314.6 kB view details)

Uploaded Source

Built Distributions

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

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

Uploaded Python 3Windows x86-64

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

Uploaded Python 3macOS 11.0+ ARM64

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

Uploaded Python 3macOS 10.15+ x86-64

File details

Details for the file flyteplugins_union-0.10.3.tar.gz.

File metadata

  • Download URL: flyteplugins_union-0.10.3.tar.gz
  • Upload date:
  • Size: 314.6 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.10.3.tar.gz
Algorithm Hash digest
SHA256 a6bbdc60d08cb18ee5e20ba63e60cebac0d41bc6e4fc3195510a12a008c224ca
MD5 6aaf478ebd752f8ccb4b9d493f784323
BLAKE2b-256 41747a8100f0316cc5c0ef40772b86f45959779f2db6736c20831f0d04ef41ff

See more details on using hashes here.

File details

Details for the file flyteplugins_union-0.10.3-py3-none-win_amd64.whl.

File metadata

File hashes

Hashes for flyteplugins_union-0.10.3-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 d3dda0bb80638b51c3f9d6c170c75b31f41250e1cd873aca39dc61dd4f576f8c
MD5 f0f1f97555765a1a76e9fb78d7341302
BLAKE2b-256 4f8049a5eb29bacbac7f8efd755214038cb761716d30e98ddadf1b5b63940478

See more details on using hashes here.

File details

Details for the file flyteplugins_union-0.10.3-py3-none-manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for flyteplugins_union-0.10.3-py3-none-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 71884f89c140845fbec913c36729d532671dca54cd7fccee2e67152af2dda8e0
MD5 94d3d5b7742a65ba85fbfa0c8f251162
BLAKE2b-256 4e6497d92250a327d2eed8205a8cfb78c934d5f2cb9801b53b018dd81e6839df

See more details on using hashes here.

File details

Details for the file flyteplugins_union-0.10.3-py3-none-manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for flyteplugins_union-0.10.3-py3-none-manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 8022119c2e966cc58bb7a425aa7853bb89f1da01a9d133d67cc391fa03e9bcb8
MD5 dbcccca22c66a25700c06912e18d905f
BLAKE2b-256 649b9f87d3d219699685db667527494363eb035265baff3bbf2ad7190d937b01

See more details on using hashes here.

File details

Details for the file flyteplugins_union-0.10.3-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for flyteplugins_union-0.10.3-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 6c35b127dcbd59413f9f7fc337e18ec30f0bb2d3be85fb256e6b74674c5f567b
MD5 8848c4636578219f80aecbccbc7e32b9
BLAKE2b-256 150154cec834cb4f4f616e47e9aa99c24cb0fddf467d0345358a727b3dd5d4a5

See more details on using hashes here.

File details

Details for the file flyteplugins_union-0.10.3-py3-none-macosx_10_15_x86_64.whl.

File metadata

File hashes

Hashes for flyteplugins_union-0.10.3-py3-none-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 9735ce7c8605fe1dd0af9fa8b30dc89bc04792c4c56c5c89de3e372879d4fe36
MD5 14c4f6c9905fc32a41bb4813cc05f47a
BLAKE2b-256 26b5bf3fa35624518627b4436e272f7b45fcee937e40285ba53009963bbac3d3

See more details on using hashes here.

Release history Release notifications | RSS feed

0.10.9

6 files

0.10.8

6 files

0.10.7

6 files

0.10.6

6 files

0.10.5

6 files

0.10.4

6 files

This release

0.10.3 This release

6 files

0.10.2

6 files

0.10.1

6 files

0.10.0

6 files

0.9.0

6 files

0.8.3

6 files

0.8.2

6 files

0.8.1

6 files

0.8.0

6 files

0.7.2

6 files

0.7.1

6 files

0.7.0

6 files

0.5.2

6 files

0.5.1

6 files

0.5.0

6 files

0.4.3

6 files

0.4.2

6 files

0.4.1

6 files

0.4.0

6 files

0.3.0

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page