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 .
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>=2.0.0b26 - The Flyte SDK v2
- 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
Metadata
Release files for flyteplugins-union 0.4.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| flyteplugins_union-0.4.1.tar.gz | 159.3 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| flyteplugins_union-0.4.1-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| flyteplugins_union-0.4.1-py3-none-manylinux2014_x86_64.whl | Python 3 | none | Linux glibc 2.17+ x86-64 | Details |
| flyteplugins_union-0.4.1-py3-none-manylinux2014_aarch64.whl | Python 3 | none | Linux glibc 2.17+ ARM64 | Details |
| flyteplugins_union-0.4.1-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
| flyteplugins_union-0.4.1-py3-none-macosx_10_15_x86_64.whl | Python 3 | none | macOS 10.15+ x86-64 | Details |
Total release size: 170.4 MB
Release files / flyteplugins_union-0.4.1.tar.gz
| Download URL | flyteplugins_union-0.4.1.tar.gz |
|---|---|
| Size | 159.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
03adb0eee5aaf67d968aaf53d5a3e4e30f01bbb2de7ab8c5a72d459fd78061b7
|
|
BLAKE2b-256 checksum How to use checksums |
1677a5159bccb88c6fc0bc91e959e7ce30d2469f4fa27b4ac817054ec757a3a6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Release files / flyteplugins_union-0.4.1-py3-none-win_amd64.whl
| Download URL | flyteplugins_union-0.4.1-py3-none-win_amd64.whl |
|---|---|
| Size | 34.6 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
d3a29e0296c853b123cbb622b3179ed810ed2b4bfa9bd9e50233c1a081549800
|
|
BLAKE2b-256 checksum How to use checksums |
93097b46c2f12818fd43742300b948ebc8b7ff30b15afc5e4f0b0de1eec56378
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Release files / flyteplugins_union-0.4.1-py3-none-manylinux2014_x86_64.whl
| Download URL | flyteplugins_union-0.4.1-py3-none-manylinux2014_x86_64.whl |
|---|---|
| Size | 34.3 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
7e4656b2895870b69bc6b369f4793a2c1947f419a456205ae37afba950a82dcd
|
|
BLAKE2b-256 checksum How to use checksums |
e9d1b81bd32d44ed841a79461c0f229ddd6b883d75ddacc4bf049b68c093842b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Release files / flyteplugins_union-0.4.1-py3-none-manylinux2014_aarch64.whl
| Download URL | flyteplugins_union-0.4.1-py3-none-manylinux2014_aarch64.whl |
|---|---|
| Size | 31.5 MB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
5c59f47773d646ab25ad6ece13ba26bb37f07a8821d89dfd442ecf527d69cc5a
|
|
BLAKE2b-256 checksum How to use checksums |
bcd1852163f5f44e96783819385ea8443c77157238c6a9c472fd2dcc16a2276c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Release files / flyteplugins_union-0.4.1-py3-none-macosx_11_0_arm64.whl
| Download URL | flyteplugins_union-0.4.1-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 34.0 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
3b0b7f9f3015c8318e4daa96c6ebfdf35e655eb33adc9bd6f01687b6a4a74c6f
|
|
BLAKE2b-256 checksum How to use checksums |
978069548902ac4e42f18c4e60087a4a15fbfe50b5bdc160c2a43e83d44e05b1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Release files / flyteplugins_union-0.4.1-py3-none-macosx_10_15_x86_64.whl
| Download URL | flyteplugins_union-0.4.1-py3-none-macosx_10_15_x86_64.whl |
|---|---|
| Size | 35.9 MB |
| Tags | Python 3 macOS 10.15+ x86-64 |
|
SHA-256 checksum How to use checksums |
fba6aba335e0858bd5e1b2d5c5d64ecc7c22711728a951405747a088d430de35
|
|
BLAKE2b-256 checksum How to use checksums |
e693a595269bad18d30d9ead85fe87e1cf81667494fe72c137dc3d98a83432d8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|