Skip to content

docs(KEP): add proposal for consolidating the python packages#12548

Open
zazulam wants to merge 1 commit intokubeflow:masterfrom
zazulam:one-pkg-proposal
Open

docs(KEP): add proposal for consolidating the python packages#12548
zazulam wants to merge 1 commit intokubeflow:masterfrom
zazulam:one-pkg-proposal

Conversation

@zazulam
Copy link
Contributor

@zazulam zazulam commented Dec 10, 2025

Description of your changes:
KEP for merging the packages into one.

Related: #12644

Checklist:

@zazulam
Copy link
Contributor Author

zazulam commented Dec 10, 2025

Regarding the tfx question that was brought up in the last community call:

Kfp-pipeline-spec came from support for the tfx use case.

From searching against the tfx repo, it looks like kfp-pipeline-spec is always installed alongside kfp, my thinking is maybe this wouldn't be as big of an issue as we thought.

@zazulam zazulam requested a review from mprahl December 10, 2025 19:39
Copy link
Collaborator

@droctothorpe droctothorpe left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/lgtm

Really excited for this improvement. Kudos, @zazulam!

@mprahl
Copy link
Collaborator

mprahl commented Dec 17, 2025

@chensun could you please review this?

This will install the consolidated package. The old packages (`kfp-pipeline-spec`, etc.) will no longer be needed as dependencies, though they may remain on PyPI for older versions.

**Breaking Changes**:
* Users directly importing `kfp_pipeline_spec`, `kfp_server_api`, or `kfp_kubernetes` will need to update their imports to `kfp.pipeline_spec`, `kfp.server_api`, and `kfp.kubernetes` respectively.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

kfp_pipeline_spec and kfp_kubernetes are kfp-namespaced package already. The imports are already kfp.pipeline_spec and kfp.kubernetes there's no change how they are imported. Only change is how they're installed.


**Question**: Should `kfp.kubernetes` be an optional dependency?

**Recommendation**: **Yes**.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1, another factor is that Vertex customers don't use kfp.kubernetes.

1. **Unit Tests**: Migrate existing unit tests from the separate repositories/directories into the `kfp` test suite.
* Specifically, `kubernetes_platform` tests will be moved to `sdk/python/kfp/kubernetes/test/`.
2. **Integration Tests**: Verify that the consolidated package works with existing integration tests.
3. **Installation Tests**: Verify that `pip install .` and `pip install kfp` work correctly in a fresh environment.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't know if this may be handled magically by pip. We should test the behavior of upgrading kfp from an older version with the extension packages installed to a newer version where extensions are included in the main kfp package, and see if the the old extension packages make cause any conflicts. I recall running into errors caused by incompatibility issues between legacy and updated modules, and when that happens the error message are sometimes confusing and not easy to debug.

Copilot AI review requested due to automatic review settings December 23, 2025 17:10
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Signed-off-by: zazulam <m.zazula@gmail.com>
@droctothorpe
Copy link
Collaborator

/lgtm
/approve

@google-oss-prow google-oss-prow bot added the lgtm label Jan 6, 2026
@google-oss-prow
Copy link

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: droctothorpe

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants