---
id: shiboken2
version: "5.15.2.1"
license: LGPL
license_treatment: copyleft
maintenance: abandoned
---

# shiboken2 — Python / C++ bindings helper module

License: copyleft · Maintenance: abandoned · Downloads: 125.7K/mo

## What it is and what it does

Shiboken2 is a utility module for inspecting and debugging Python bindings generated from C++ code, primarily used within the Qt for Python ecosystem. It exposes functions to check whether a Python wrapper object is still valid—that is, whether the underlying C++ object it wraps has been destroyed—and provides other binding-related metadata useful for integration work and debugging.

The package has no runtime dependencies and ships as platform-specific wheels for Windows, macOS, and Linux. However, it is abandoned: the last release was 1673 days ago, and no active maintenance or security updates are planned. It is designed to be used alongside C++/Python binding frameworks, not as a standalone tool.

Use it for:

- Debug applications to detect when Python wrappers reference destroyed C++ objects
- Validate binding integrity during C++/Python integration testing
- Inspect binding metadata to understand wrapper lifecycle in mixed-language codebases
- Troubleshoot segmentation faults caused by invalid wrapper access after C++ cleanup

## Worth the install?

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

Shiboken2 provides Python access to metadata and utilities for C++/Python bindings, letting you inspect binding validity and debug wrapper state after C++ object destruction.

No. Shiboken2 is abandoned (last release 1673 days ago) with no active maintenance or security updates. If you are actively using a binding framework that depends on it, verify whether your version still bundles shiboken2; if you need binding introspection for new projects, evaluate whether your binding framework itself is still maintained first.

## Install

pip install shiboken2
uv add shiboken2
poetry add shiboken2

## Installing shiboken2

Before you install: Medium install friction due to platform-specific wheels across Windows, macOS, and Linux variants. Package is abandoned—last release was 1673 days ago—so no active maintenance or security updates are forthcoming.

License in practice: Dual-licensed under LGPL (copyleft) and proprietary terms. LGPL copyleft obligations apply to derivative works; proprietary license terms may offer alternatives under separate agreement.

Quickstart:

import shiboken2

# Check if a Python object wraps a valid C++ instance
is_valid = shiboken2.isValid(some_cpp_wrapped_object)
print(is_valid)

Requires a pre-existing C++-wrapped Python object (typically from PySide2 or similar binding); shiboken2 alone does not create bindings.

Verify before relying:

- Whether shiboken2 5.15.2.1 remains compatible with Python versions beyond the <3.11 cap
- Current state of Qt for Python maintenance and whether shiboken2 is still usable with active versions
- Whether the dual LGPL/proprietary license terms are clearly documented in the package or require external reference

## Package facts

- License: LGPL (copyleft)
- Python support: capped_below_current
- Install friction: medium
- Maintenance: abandoned
- Downloads: 125.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

c++ python bindings introspection, shiboken binding metadata, python wrapper validation, qt for python bindings, c++ object lifecycle debugging, binding generation utilities, pyside binding tools, qt-bindings, c++-integration, abandoned

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