lightkube-models

What it is and what it does

lightkube-models is a Python package containing auto-generated type definitions and model classes for Kubernetes resources. It serves as a companion to the lightkube client library, providing the schema definitions needed to interact with Kubernetes APIs in a type-safe way. The package versions are aligned with Kubernetes schema versions—the first three version parts (major.minor.micro) correspond to the Kubernetes release the models were generated from, so you should install a version matching your cluster or compatible resources.

The package contains no runtime dependencies and installs as a pure Python wheel, making it lightweight and quick to set up. It supports Python 3.8 through 3.14, and is actively maintained with recent releases.

Use it for:

• Type-safe Kubernetes resource definitions when using lightkube for cluster automation or management.
• IDE autocomplete and static type checking for Kubernetes object construction in Python.
• Generating or validating Kubernetes manifests programmatically with correct schema definitions.
• Building Kubernetes operators or controllers that need accurate resource models.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides Python type definitions and model classes for Kubernetes resources, designed to work with the lightkube client library.

Yes, if you are using lightkube. It is a lightweight, actively maintained dependency with no transitive dependencies, permissive licensing, and no known vulnerabilities. Install the version matching your Kubernetes cluster version for best compatibility.

Install

lightkube-models on PyPI

pip install lightkube-models

uv add lightkube-models

poetry add lightkube-models

Installing lightkube-models

Before you install

Low install friction with no runtime dependencies. Actively maintained as of 2026-07-26 with recent releases, though the project has modest visibility (4 stars).

License in practice

MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.

Quickstart

pip install lightkube-models==1.36.3.8

import lightkube_models

Requires Python 3.9 or later.

Verify before relying

• Whether version matching between lightkube-models and actual Kubernetes cluster version is strictly required or merely recommended.
• Whether this package can be used independently or only as a dependency of lightkube.

Package facts

Evidence: lightkube_models-1.36.3.8-py3-none-any.whl

Tags

More Distributed Computing packages