---
id: shiboken6
version: "6.11.1"
license: LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
license_treatment: copyleft
maintenance: active
---

# shiboken6 — Python/C++ bindings helper module

License: copyleft · Maintenance: active · Downloads: 3.7M/mo

## What it is and what it does

Shiboken6 is a utility module that exposes the internals of Python/C++ bindings generated by the Shiboken binding generator. It lets you inspect and validate binding objects at runtime—checking whether a Python wrapper is still valid after its underlying C++ object has been destroyed, or retrieving metadata about the binding itself. This is primarily useful for developers building Qt for Python applications or integrating C++ libraries into Python, where understanding the state of language-boundary objects can be critical for debugging memory issues or wrapper lifecycle problems.

The module is part of the Qt for Python project and provides a programmatic interface to binding introspection that would otherwise be opaque. It has no runtime dependencies and supports Python 3.10 through 3.14 across macOS, Linux, and Windows platforms.

Use it for:

- Debug memory lifecycle issues by checking if C++ objects underlying Python wrappers have been destroyed
- Validate binding object state before calling methods that depend on valid C++ pointers
- Inspect binding metadata during development of custom Shiboken-generated bindings
- Diagnose crashes caused by stale wrapper references in long-running applications

## Worth the install?

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

Shiboken6 provides Python access to metadata and introspection functions for C++/Python bindings, allowing you to check object validity and debug wrapper state in applications built with Qt for Python.

Yes, if you are developing with Qt for Python or maintaining Shiboken-generated bindings. The module is actively maintained, has no security vulnerabilities, and fills a specific debugging and introspection niche. The copyleft license is standard for Qt tooling. Install only if you actually need binding introspection; it is not a general-purpose library.

## Install

pip install shiboken6
uv add shiboken6
poetry add shiboken6

## Installing shiboken6

Before you install: Medium install friction due to platform-specific wheels; actively maintained with recent release 93 days ago.

License in practice: Copyleft license (LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only) requires derivative works to be licensed under compatible terms; proprietary use requires explicit license choice or commercial agreement.

Quickstart:

import shiboken6
# Check if a Python wrapper is valid after C++ object destruction
if shiboken6.isValid(wrapped_object):
    # Safe to call methods on the wrapper
    pass

Requires Python 3.10 or later (supports up to 3.14); platform-specific wheels for macOS, Linux, and Windows

Verify before relying:

- Whether shiboken6 can be used standalone or requires additional Qt for Python packages
- Specific debugging capabilities and introspection API surface beyond object validity checks
- Performance characteristics when checking object validity in high-frequency code paths

## Package facts

- License: LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only (copyleft)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 3.7M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

python c++ bindings introspection, shiboken object validation, qt for python debugging, c++ wrapper metadata, binding utilities, qt-for-python, c++-bindings, debugging

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