Model integrations

Install a model package to use typed clients for an existing Kubernetes API. These packages do not install upstream operators or CRDs. Match the model version to the API you run, and pin a compatible Cloudcoil minor; see the versioning guide.

The core installation extras include:

Name	Github	PyPI
cert-manager	models-cert-manager	cloudcoil.models.cert_manager
fluxcd	models-fluxcd	cloudcoil.models.fluxcd
istio	models-istio	cloudcoil.models.istio
keda	models-keda	cloudcoil.models.keda
knative-serving	models-knative-serving	cloudcoil.models.knative_serving
knative-eventing	models-knative-eventing	cloudcoil.models.knative_eventing
kpack	models-kpack	cloudcoil.models.kpack
kyverno	models-kyverno	cloudcoil.models.kyverno
prometheus-operator	models-prometheus-operator	cloudcoil.models.prometheus_operator
sealed-secrets	models-sealed-secrets	cloudcoil.models.sealed_secrets
velero	models-velero	cloudcoil.models.velero

You can install these integrations using

uv add 'cloudcoil[kyverno]'
# You can also install multiple dependencies at once
uv add 'cloudcoil[cert-manager,fluxcd,kyverno]'
# You can also install all available models in cloudcoil using
uv add 'cloudcoil[all-models]'

Missing an integration you need? Open a model request to suggest a new integration!

New integration sources

Additional generation configurations and resource round-trip tests are maintained in this repository. They do not have core installation extras. Generate them from the checkout with make gen-repo-<name>; consult the corresponding model repository for its published packages.

Integration	Initially validated upstream version	Generation target
Argo CD	3.5.2	make gen-repo-argocd
Contour	1.33.7	make gen-repo-contour
Crossplane	2.4.0	make gen-repo-crossplane
Tekton Pipelines	1.15.1	make gen-repo-tekton

After rendering, run make gen-models lint test inside output/models-<name>. For version update PRs and publishing, see Maintaining model packages.