---
id: kubernetes-stubs
version: "22.6.0.post1"
license: Apache-2.0
license_treatment: permissive
maintenance: abandoned
---

# kubernetes-stubs — Type stubs for the Kubernetes Python API client

License: permissive · Maintenance: abandoned · Downloads: 654.6K/mo

## What it is and what it does

kubernetes-stubs is a type-stub package that mirrors the Kubernetes Python API client's public interface, allowing static type checkers and IDEs to understand the types and signatures of client calls. Type stubs are metadata-only files that describe what types a library exposes; they don't add runtime behavior.

The package is useful if you write type-checked Python code that uses the Kubernetes client library. Its version numbers track the upstream package, so version 22.6.0.post1 corresponds to Kubernetes client 22.6.0. However, the package has not been updated since 2022-04-20 and is no longer maintained, meaning it will not reflect API changes in newer client releases.

Use it for:

- Enable type checking in scripts that call the Kubernetes Python client
- Get IDE autocompletion and inline type hints when writing Kubernetes client code
- Verify at development time that your API calls match the client's expected signatures
- Maintain a typed codebase that depends on the Kubernetes client without type errors

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Python type stubs for the Kubernetes API client, enabling static type checking and IDE autocompletion when working with the upstream kubernetes package.

Yes, if you are using Kubernetes client version 22.6.x and need type checking support. No, if you use a newer client version—the stubs are outdated and will not reflect current API. Check whether the upstream package now includes inline type hints or whether an actively maintained alternative exists before installing.

## Install

pip install kubernetes-stubs
uv add kubernetes-stubs
poetry add kubernetes-stubs

## Installing kubernetes-stubs

Before you install: Installation is straightforward with no runtime dependencies. However, the package is abandoned—last release was 1577 days ago—so it will not track upstream Kubernetes API changes or receive maintenance.

License in practice: Licensed under Apache-2.0 (permissive), so you can use it freely in commercial and open-source projects without copyleft obligations.

Quickstart:

pip install kubernetes-stubs

Verify before relying:

- Whether these stubs remain accurate for current versions of the Kubernetes Python API client
- Compatibility with Python versions beyond 3.10 (the newest explicitly declared in classifiers)

## Package facts

- License: Apache-2.0 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 654.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

kubernetes type stubs, kubernetes python typing, k8s api client types, kubernetes type hints, static type checking kubernetes, kubernetes mypy stubs, kubernetes client type annotations, type-stubs, kubernetes, abandoned

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