Install & Compatibility
Where this runs
tested against v1.43.14 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.756s · 52.5MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 3.9s · import 0.700s · 53MB
51MB installed
● package 51MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
QConnectClient
✓ from mypy_boto3_qconnect.client import QConnectClient
QueryKnowledgeBaseResponseTypeDef
✓ from mypy_boto3_qconnect.type_defs import QueryKnowledgeBaseResponseTypeDef
QConnectServiceName
✓ from mypy_boto3_qconnect.literals import QConnectServiceName
Demonstrates how to initialize a `boto3` QConnect client with `mypy-boto3-qconnect` type hints and perform a basic operation, showcasing how types are applied to both the client and its method responses.
import boto3
from mypy_boto3_qconnect.client import QConnectClient
from mypy_boto3_qconnect.type_defs import QueryKnowledgeBaseResponseTypeDef
# Ensure boto3 is installed and configured (e.g., via AWS CLI or env vars)
# A client without explicit credentials will use default AWS configuration.
# Use type hint for the boto3 client
client: QConnectClient = boto3.client("qconnect")
# Example: List knowledge bases
try:
# Type checking will ensure correct arguments and return types
response = client.list_knowledge_bases()
print("Successfully listed knowledge bases:")
for kb in response.get("knowledgeBaseSummaries", []):
print(f" - {kb['name']} ({kb['knowledgeBaseId']})")
# Example with a specific operation and its TypedDict return type
# Note: Replace 'your-knowledge-base-id' and 'your-query' with actual values
# if you want to run this part.
# query_response: QueryKnowledgeBaseResponseTypeDef = client.query_knowledge_base(
# knowledgeBaseId="your-knowledge-base-id",
# queryText="your-query"
# )
# print("Query response type checked.")
except Exception as e:
print(f"An error occurred: {e}")
print("Ensure your AWS credentials are configured and QConnect has resources.")
Debug
Known issues
breakingPython 3.8 is no longer supported. Packages built with `mypy-boto3-builder` version 8.12.0 and higher (including `mypy-boto3-qconnect 1.42.84`) require Python 3.9 or newer.fixUpgrade your Python environment to 3.9 or newer. If you must use Python 3.8, pin an older `mypy-boto3-qconnect` version (e.g., `mypy-boto3-qconnect<1.42.0`).
affects: mypy-boto3-qconnect <= 1.41.x (built with builder < 8.12.0) support Python 3.8. Versions >= 1.42.x require Python 3.9+.
gotchaThis package provides only type stubs. You must install `boto3` separately for actual runtime functionality. Forgetting `boto3` will lead to `ModuleNotFoundError` or similar runtime issues.fixAlways install both `mypy-boto3-qconnect` and `boto3`: `pip install mypy-boto3-qconnect boto3`.
affects: All versions
breakingSome `TypedDict` argument names (e.g., `CreateDistributionRequestRequestTypeDef`) were shortened or renamed to avoid redundancy in `mypy-boto3-builder` 8.9.0. While `qconnect` specifically fixed self-references in 8.11.0, other services saw general renaming. Review your code for `*RequestRequestTypeDef` patterns.fixUpdate your code to use the simplified `TypeDef` names. For `QConnect`, explicitly check relevant `TypedDict`s for breaking changes if upgrading from very old versions.
affects: mypy-boto3-qconnect built with builder < 8.9.0 might use longer, redundant TypeDef names. Versions built with >= 8.9.0 use shorter names.
gotchaPrevious versions of `mypy-boto3-qconnect` (built with `mypy-boto3-builder` prior to 8.11.0) had issues with self-references in `TypedDict`s which could lead to incorrect type checking or errors. This was specifically fixed for `qconnect`.fixEnsure you are using `mypy-boto3-qconnect` version built with `mypy-boto3-builder` 8.11.0 or newer (e.g., `1.42.x` or later) to benefit from the fix.
affects: mypy-boto3-qconnect versions built with `mypy-boto3-builder < 8.11.0`.
gotchaThe `mypy-boto3-builder` migrated to PEP 561-compliant packages in version 8.12.0. This change ensures better compatibility with `mypy` and other type checkers but might require `mypy` to be updated or reconfigured in some complex setups if type resolution issues arise.fixEnsure your `mypy` configuration is up-to-date. Typically, no direct action is needed unless you encounter type resolution errors not present in earlier versions.
affects: All versions built with `mypy-boto3-builder` 8.12.0 and later.
Upgrade
Version history
1.43.14latest on PyPI · released May 22, 2026
Audit
Dependencies
boto3requiredRuntime library for AWS SDK interactions. `mypy-boto3-qconnect` provides only type stubs, not functionality.