---
id: lightkube-models
version: "1.36.3.8"
license: MIT
license_treatment: permissive
maintenance: active
---

# lightkube-models — Models and Resources for lightkube module

License: permissive · Maintenance: active · Downloads: 407.4K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 407.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

kubernetes python models, k8s resource definitions, lightkube models, kubernetes schema python, k8s type definitions, kubernetes, type-definitions

[View on SkillFed](https://skillfed.io/packages/lightkube-models) · [View on PyPI](https://pypi.org/project/lightkube-models/)