Install & Compatibility
Where this runs
tested against v0.828.1 · 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.920 runs
installs and imports cleanly · install 0.0s · import 0.950s · 32.9MB
glibcpy 3.10–3.920 runs
installs and imports cleanly · install 4.2s · import 0.868s · 33MB
31MB installed
● package 31MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
AIInbx
✓ from aiinbx import AIInbx
AsyncAIInbx
✓ from aiinbx import AsyncAIInbx
Use for asynchronous API calls in `async`/`await` contexts.
APIStatusError
✓ from aiinbx import APIStatusError
✗ from aiinbx.errors import APIStatusError
Common error classes are directly exposed at the top level since v0.8xx, no need to import from `aiinbx.errors` directly.
Initializes the AIInbx client using an API key from an environment variable and demonstrates how to make a basic API call to list messages. The exact API methods and their parameters should be verified against the official AIInbx documentation.
import os
from aiinbx import AIInbx
# Initialize the client with your API key from an environment variable
client = AIInbx(
api_key=os.environ.get("AIINBX_API_KEY", ""),
)
# Example: List messages
try:
# This call might vary based on specific AIInbx API methods
# Check official documentation for the latest methods (e.g., client.messages.list())
messages_page = client.messages.list()
for message in messages_page.data:
print(f"Message ID: {message.id}, Content snippet: {message.content[:50]}...")
print(f"Total messages retrieved: {len(messages_page.data)}")
except Exception as e:
print(f"An error occurred: {e}")
if not os.environ.get("AIINBX_API_KEY"):
print("Please ensure the AIINBX_API_KEY environment variable is set.")
Debug
Known issues
gotchaThe AIInbx API and its Python client are under active development, leading to frequent version updates (often daily or weekly). While semantic versioning is generally followed, minor versions may introduce new features or slight breaking changes that require keeping your library updated.fixRegularly update the `aiinbx` library (`pip install --upgrade aiinbx`) and refer to the GitHub releases page for detailed changelogs. Pinning to exact patch versions might be necessary for production systems to avoid unexpected behavior.
affects: All versions
breakingFrequent 'api update' features in minor versions (e.g., v0.826.0 -> v0.827.0) indicate that the available methods, their signatures, or the structure of response objects may change. Your existing code might break if methods are renamed or removed, or if data structures evolve.fixConsult the changelog on GitHub for each update to understand specific API changes. Ensure your code handles potential `AttributeError` for missing methods or `KeyError` for missing fields in response objects gracefully. Consider using types/models provided by the library.
affects: All versions, especially between minor releases (0.x.0 to 0.y.0)
gotchaWhen uploading files, ensure they are passed correctly as a single parameter, especially if using a dictionary for multipart forms. A bug fix in v0.827.2 addressed an issue where file data might be sent incorrectly.fixUpgrade to `aiinbx` v0.827.2 or newer. When sending files, follow the exact pattern shown in the official documentation for the specific endpoint, often using `files={'file': ('filename.ext', file_object, 'mimetype')}` if the API expects multipart form data. affects: <=0.827.1
Errors
Common errors & fixes
aiinbx.APIStatusError: 401 Unauthorized
The AIInbx API Key is missing, incorrect, or expired.
fixEnsure the `AIINBX_API_KEY` environment variable is set correctly or pass the `api_key` argument directly to the `AIInbx` client constructor with a valid key: `client = AIInbx(api_key='YOUR_SECRET_KEY')`.
AttributeError: 'Messages' object has no attribute 'get_all'
An API method name has changed (e.g., from `get_all` to `list`) or was never exposed under that name.
fixRefer to the latest AIInbx API documentation or the library's source code/changelog for the correct method names (e.g., `client.messages.list()`). API endpoints often standardize on `list`, `retrieve`, `create`, `update`, `delete`.
TypeError: Expected a sync client, but got an async client. You likely used 'await' with a sync client method.
You are trying to use `await` on a method of the synchronous `AIInbx` client.
fixIf you intend to use asynchronous operations, instantiate `AsyncAIInbx` instead of `AIInbx`: `from aiinbx import AsyncAIInbx; async_client = AsyncAIInbx(...)`. Then, ensure your code runs within an `async` function and uses `await` correctly for all API calls.
Upgrade
Version history
0.828.1latest on PyPI · released May 9, 2026
Audit
Dependencies
No dependency data recorded yet.