---
id: kubernetes-stubs-elephant-fork
version: "36.0.3.post1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

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

License: permissive · Maintenance: active · Downloads: 3.0M/mo

## What it is and what it does

This package provides type stub files (.pyi) for the Kubernetes Python API client library. Type stubs allow static type checkers like mypy and Pyright to understand the Kubernetes library's API surface, and they enable IDE features like autocomplete and inline documentation. The package exists as a fork because the upstream kubernetes-stubs project had not kept pace with Kubernetes releases; this fork automates stub generation to track new Kubernetes releases.

You install it alongside the main kubernetes package. It has no runtime dependencies and does not affect how your code runs—it only improves the development experience by making type information available to your tools. The maintainer uses GitHub Actions to detect new Kubernetes releases and automatically build corresponding stubs, so the package stays synchronized with the upstream library.

Use it for:

- Enable mypy or Pyright to type-check code that uses the Kubernetes Python client without false positives.
- Get IDE autocomplete and inline API documentation when writing Kubernetes client code in VSCode or PyCharm.
- Catch Kubernetes API usage errors at development time rather than at runtime.
- Maintain type safety in large projects that orchestrate or manage Kubernetes clusters via Python.

## Worth the install?

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

Provides type stubs for the Kubernetes Python API client, enabling static type checking and IDE autocompletion for Kubernetes library code.

Yes, if you use the Kubernetes Python client and want static type checking or IDE support. It has no runtime cost, low install friction, and is actively maintained. The main caveat is verifying that the stubs match your installed Kubernetes client version—check the fork's release notes to confirm coverage for your version.

## Install

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

## Installing kubernetes-stubs-elephant-fork

Before you install: Low install friction with no runtime dependencies. Actively maintained with recent releases; the maintainer runs automated builds to track new Kubernetes releases, so stubs stay current.

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

Quickstart:

pip install kubernetes-stubs-elephant-fork

# Then use with your type checker (mypy, pyright, etc.)
# Your IDE will now provide autocomplete for kubernetes library imports
import kubernetes.client
api = kubernetes.client.CoreV1Api()

Verify before relying:

- Whether stubs cover all Kubernetes client versions >= 7.0 or only specific releases
- Compatibility with the main kubernetes package version you're using
- Whether this fork is actively maintained beyond the automated release tracking

## Package facts

- License: Apache-2.0 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 3.0M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

kubernetes type stubs, kubernetes python typing, kubernetes api type hints, kubernetes static type checking, kubernetes mypy stubs, kubernetes ide autocomplete, type stubs kubernetes client, type-stubs, kubernetes, static-typing

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