ibm-watsonx-ai
IBM watsonx.ai API Client
Decision gist · record as of 2026-08-14
Yes. The package is actively maintained (release 3 days old), carries no known vulnerabilities, has low install friction, and is production-stable (Development Status 5). It is the official and necessary client for any developer working with IBM watsonx.ai. Install it if you are building or deploying AI models on the watsonx.ai platform; skip it if you are not using that specific IBM service.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires valid IBM watsonx.ai credentials (API key and space/project ID) and network access to IBM Cloud or on-premises watsonx.ai deployment.
- Low friction installation with a pure Python wheel; actively maintained with a release 3 days old.
- Requires Python 3.11–3.14 and brings 10 runtime dependencies including requests, httpx, pandas, and ibm-cos-sdk.
License · maintenance · safety
BSD-3-Clause (permissive) — BSD-3-Clause permissive license allows commercial and private use with minimal restrictions; suitable for enterprise deployments.
last release 2026-08-11 (3 days) · last repo commit 2026-08-12 · 175 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 2,585,364 downloads/mo, #2,983 on PyPI
Alternatives
Verify before relying
pip install ibm-watsonx-ai
from ibm_watsonx_ai import Credentials, APIClient
from ibm_watsonx_ai.foundation_models import ModelInference
credentials = Credentials(url="https://us-south.ml.cloud.ibm.com", api_key="<key>")
api_client = APIClient(credentials, space_id="<space-id>")
model = ModelInference(api_client=api_client, model_id="ibm/granite-4-h-small")
response = model.chat(messages=[{"role": "user", "content": "Hello"}])- Whether optional extras (rag, mcp) are included in the standard install or require separate installation.
- Performance characteristics and rate limits for concurrent inference requests.
- Specific model availability and versioning strategy across watsonx.ai deployments.
What it is and what it does
ibm-watsonx-ai is the official Python client for IBM's enterprise AI platform, watsonx.ai. It abstracts authentication, API communication, and model lifecycle management into a single SDK, enabling developers to build, tune, deploy, and invoke foundation models (LLMs, embeddings, time-series, audio), run AutoAI experiments, construct retrieval-augmented generation systems, and integrate enterprise data sources—all from Python code.
The SDK is designed for the full AI lifecycle: from research prototyping to production deployment on IBM Cloud or on-premises watsonx.ai. It handles secure credential management, provides a unified interface to multiple model families and inference modes (chat, embeddings, fine-tuning), and integrates with IBM Cloud Object Storage (ibm-cos-sdk) for data and artifact management. With 10 runtime dependencies focused on HTTP communication, data handling, and caching, it is production-ready and suitable for enterprise environments requiring governance and scalability.
Use it for
- Build conversational AI applications using foundation models like Granite or Llama via the ModelInference chat interface.
- Construct retrieval-augmented generation (RAG) systems that combine enterprise documents with LLM inference.
- Run AutoAI experiments to automatically discover and tune models for structured data tasks.
- Fine-tune and prompt-tune foundation models on domain-specific data within the watsonx.ai platform.
- Deploy trained models to scalable inference endpoints and manage their lifecycle through the SDK.
- Integrate enterprise data sources and IBM Cloud Object Storage into AI workflows for end-to-end ML pipelines.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
The package is actively maintained (release 3 days old), carries no known vulnerabilities, has low install friction, and is production-stable (Development Status 5). It is the official and necessary client for any developer working with IBM watsonx.ai. Install it if you are building or deploying AI models on the watsonx.ai platform; skip it if you are not using that specific IBM service.
Install
ibm-watsonx-ai on PyPI
Before you install
Low friction installation with a pure Python wheel; actively maintained with a release 3 days old. Requires Python 3.11–3.14 and brings 10 runtime dependencies including requests, httpx, pandas, and ibm-cos-sdk.
Requires valid IBM watsonx.ai credentials (API key and space/project ID) and network access to IBM Cloud or on-premises watsonx.ai deployment.
License in practice
BSD-3-Clause permissive license allows commercial and private use with minimal restrictions; suitable for enterprise deployments.
Quickstart
pip install ibm-watsonx-ai
from ibm_watsonx_ai import Credentials, APIClient
from ibm_watsonx_ai.foundation_models import ModelInference
credentials = Credentials(url="https://us-south.ml.cloud.ibm.com", api_key="<key>")
api_client = APIClient(credentials, space_id="<space-id>")
model = ModelInference(api_client=api_client, model_id="ibm/granite-4-h-small")
response = model.chat(messages=[{"role": "user", "content": "Hello"}])Verify before relying
- Whether optional extras (rag, mcp) are included in the standard install or require separate installation.
- Performance characteristics and rate limits for concurrent inference requests.
- Specific model availability and versioning strategy across watsonx.ai deployments.
Package facts
| License | BSD-3-Clause permissive |
| Python support | Supports the current Python release <3.15,>=3.11 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 10 packagesrequestshttpxurllib3pandascertifilomondtabulatepackagingibm-cos-sdkcachetools |
| Maintenance | Actively maintained 3 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 2,585,364 / month, #2,983 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersIntended Audience :: Information TechnologyIntended Audience :: Science/ResearchLicense :: OSI Approved :: BSD LicenseNatural Language :: EnglishOperating System :: MacOS :: MacOS XOperating System :: Microsoft :: WindowsOperating System :: POSIX :: LinuxProgramming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: InternetTopic :: Scientific/Engineering :: Artificial IntelligenceTopic :: Scientific/Engineering :: Information AnalysisTopic :: Software Development :: LibrariesTopic :: Software Development :: Libraries :: Python Modules |
Evidence: ibm_watsonx_ai-1.6.3-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “IBM watsonx.ai Python SDK”
- ibm-watsonx-aiOfficial Python SDK for IBM watsonx.ai that provides a unified…
- llama-index-llms-ibmIntegrates IBM watsonx.ai foundation models with LlamaIndex's LLM…
- llama-index-embeddings-ibmIntegrates IBM watsonx.ai embedding models with LlamaIndex, allowing…
Give your agent the search over MCP, or paste the wish link into any chat.
More Libraries packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
Provides parsing, arithmetic, and recurrence rule computation for dates and times, with timezone support and iCalendar RFC compliance.
Install it if you need to parse flexible date strings, compute relative dates, handle timezones, or work with recurrence rules—it's the de facto choice for these tasks.
Six provides utility functions to write Python code that runs on both Python 2.7 and Python 3.3+, smoothing over language differences between the two versions.
pytest is a testing framework that lets you write test functions using plain assert statements and automatically discovers and runs them, with detailed failure reporting.
See also ibm-watson-machine-learning · llama-index-llms-ibm · langchain-ibm · llama-index-embeddings-ibm · opentelemetry-instrumentation-watsonx · ibm-cos-sdk-core · ibm-platform-services · ibm-vpc · azure-ai-inference · ibm-cloud-sdk-core