Skip to content

Resources & Models


lightkube-models 1.29, 1.28, 1.27, 1.26, 1.25, 1.24, 1.23, 1.22, 1.21, 1.20, 1.19, 1.18, 1.17, 1.16, 1.15


Kubernetes API provides access to several resource kinds organized by version and API group. Lightkube represents such resources using classes that can be found inside the package lightkube.resources.

Resources are organized in modules where the name follow the convention {group}_{version}. For example the group apps on version v1 includes the resource kind Deployment and it can be accessed as follow from lightkube.resources.apps_v1 import Deployment.

Resource classes can be used to call the lightkube client methods or to instantiate the corresponding objects.

>>> from lightkube import Client
>>> from lightkube.resources.apps_v1 import Deployment

>>> client = Client()
>>> dep = client.get(Deployment, name="my-deo")
>>> type(dep)
<class 'lightkube.resources.apps_v1.Deployment'>


Some kubernetes resources provide extra subresources like /status. Subresources can be found as attributes of the corresponding resource class. For example Deployment provides Deployment.Status and Deployment.Scale. Similar to resources, subresources can be used directly with the lightkube client.


The package lightkube.models provides models for all schemas defined in the kubernetes API. The models are split in modules in a similar way to resources (i.e. the module name match {group}_{version}). All models are defined using standard python dataclasses and are used to create or retrieve kubernetes objects.

>>> from lightkube.models.meta_v1 import ObjectMeta
>>> ObjectMeta(name='test', namespace='default')
ObjectMeta(annotations=None, clusterName=None, creationTimestamp=None, deletionGracePeriodSeconds=None, deletionTimestamp=None, finalizers=None, generateName=None, generation=None, initializers=None, labels=None, managedFields=None, name='test', namespace='default', ownerReferences=None, resourceVersion=None, selfLink=None, uid=None)

Resources are also subclasses of models but they hold extra information regarding the way the resource can be accessed. The lightkube client need such information, so will only accept resources or resource instances as parameters.


Resource and Models are part of a separate python package named lightkube-models. This package follows the version of the corresponding kubernetes API:


For example the package version match kubernetes version 1.15.6 at release 1.

Depending on the Kubernetes server in use, the appropriate version should be selected as follow lightkube-models>=1.15,<1.16.

A list of available versions, can be seen on pypi.