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 codeflyteplugins/union/cli/- CLI command plugins that extend the Flyte CLIflyteplugins/union/utils/- Shared utility functionsflyteplugins/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.*andflyteplugins.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
2 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file flyteplugins_union-0.10.9.tar.gz.
File metadata
- Download URL: flyteplugins_union-0.10.9.tar.gz
- Upload date:
- Size: 327.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1f55c9eaeeb933d122bdbcaed8a60d9df50e7ff9550caeeeb91fdbec02195117
|
|
| MD5 |
4dd3acba90460cab9395d0a8beaac874
|
|
| BLAKE2b-256 |
08ea96c3e5b3f13179c7024c0d484d9ae231ba09f692634dab1a475636d5f397
|
File details
Details for the file flyteplugins_union-0.10.9-py3-none-win_amd64.whl.
File metadata
- Download URL: flyteplugins_union-0.10.9-py3-none-win_amd64.whl
- Upload date:
- 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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c9b4448ebfe25d0a4f273713e6873027c31aedfffcccfac8c38bf918922c10d9
|
|
| MD5 |
6318f0250ff8faef979b6193c69db960
|
|
| BLAKE2b-256 |
95498a5c87462a5f22006bfd3e795ce0c873d31393e4b7b8dc7640961c6e19e4
|
File details
Details for the file flyteplugins_union-0.10.9-py3-none-manylinux2014_x86_64.whl.
File metadata
- Download URL: flyteplugins_union-0.10.9-py3-none-manylinux2014_x86_64.whl
- Upload date:
- Size: 21.7 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
148980c8190f9bf43fc3b703ad1c54af1ef4f0ca7432164d84ea42e791faf697
|
|
| MD5 |
5df2805ef37d2aece8ee656e76eaddfb
|
|
| BLAKE2b-256 |
a4ca8acd7289777d16f22cfaf8c9ece67099934c2fbd6b43ae26d1ff2e961971
|
File details
Details for the file flyteplugins_union-0.10.9-py3-none-manylinux2014_aarch64.whl.
File metadata
- Download URL: flyteplugins_union-0.10.9-py3-none-manylinux2014_aarch64.whl
- Upload date:
- Size: 19.3 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ae964e67ac63ca5dd211a646a5e979cf6d3301cb4385f2160ee73be0b39ece18
|
|
| MD5 |
54041eba1130360264169822a4247a7a
|
|
| BLAKE2b-256 |
393fa6a48e2f0b9f4c2aa62b35b3d55947a33fea9d79a726639571e95613718e
|
File details
Details for the file flyteplugins_union-0.10.9-py3-none-macosx_11_0_arm64.whl.
File metadata
- Download URL: flyteplugins_union-0.10.9-py3-none-macosx_11_0_arm64.whl
- Upload date:
- 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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ff313302a65703cb893762566ed5c3ec63961a07904d7de8dad85d9830b04e10
|
|
| MD5 |
2f56b009e980054e3499b9c831fa219d
|
|
| BLAKE2b-256 |
326d97e54798e1c9a05d0e3d8391ff7b8cc30dda5bcdd28542c2d3ba43bcc8d1
|
File details
Details for the file flyteplugins_union-0.10.9-py3-none-macosx_10_15_x86_64.whl.
File metadata
- Download URL: flyteplugins_union-0.10.9-py3-none-macosx_10_15_x86_64.whl
- Upload date:
- 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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
df9001ec83c22777874548a286c5a779572db2e6119d74c35d5a33d48b67a3dc
|
|
| MD5 |
4169bcf69d257bc7bb891d754a7d0f4a
|
|
| BLAKE2b-256 |
41c0ea1f94ddf921e6ac8e00e94543a39c91309c7967d0cef07be54f0bd8ed86
|
