{"id":23871,"library":"ibm-watsonx-orchestrate","title":"IBM watsonx Orchestrate Python SDK","description":"The IBM watsonx Orchestrate Python SDK (ADK) enables developers to build, orchestrate, and deploy AI assistants and workflows using watsonx Orchestrate capabilities. Current version is 2.9.0, with a rapid release cadence. Requires Python >=3.11,<3.14.","status":"active","version":"2.9.0","language":"python","source_language":"en","source_url":"https://github.com/IBM/watsonx-orchestrate-python-sdk","tags":["ai","orchestration","skills","assistants","ibm-watsonx"],"install":[{"cmd":"pip install ibm-watsonx-orchestrate","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Core authentication and HTTP client for IBM Cloud services","package":"ibm-cloud-sdk-core","optional":false},{"reason":"Required for invoking watsonx.ai models within skills","package":"ibm-watsonx-ai","optional":false}],"imports":[{"wrong":"from ibm_watsonx_orchestrate import Orchestrate","symbol":"Orchestrate","correct":"from ibm_watsonx_orchestrate import Orchestrate"}],"quickstart":{"code":"from ibm_watsonx_orchestrate import Orchestrate, Skill\n\norchestrate = Orchestrate(\n    api_key=os.environ.get('WATSONX_API_KEY', ''),\n    url=os.environ.get('WATSONX_URL', '')\n)\n\n# Create a skill\nskill = Skill(\n    name='HelloSkill',\n    description='A simple greeting skill',\n    actions=[\n        {\n            'name': 'greet',\n            'description': 'Greets the user',\n            'type': 'function',\n            'function': {\n                'parameters': {\n                    'type': 'object',\n                    'properties': {\n                        'name': {'type': 'string'}\n                    }\n                }\n            }\n        }\n    ]\n)\n\n# Deploy the skill\nresponse = orchestrate.skills.create(skill)\nprint(f'Skill created: {response['result']['id']}')\nprint('Quickstart complete!')","lang":"python","description":"Initialize the SDK, create a skill with a simple function, and deploy it to watsonx Orchestrate. Requires WATSONX_API_KEY and WATSONX_URL environment variables."},"warnings":[{"fix":"Update imports: `from ibm_watsonx_orchestrate import Orchestrate`. Replace `iam_apikey` parameter with `api_key`.","message":"In v2.0, the SDK was restructured: imports changed from `ibm_watsonx_orchestrate.api` to `ibm_watsonx_orchestrate`. The `Orchestrate` client no longer accepts `iam_apikey`; use `api_key` instead.","severity":"breaking","affected_versions":"<=1.x -> 2.0+"},{"fix":"Replace `list()` with `search()` and adjust parameters if needed.","message":"Method `orchestrate.skills.list()` is deprecated in favor of `orchestrate.skills.search()`.","severity":"deprecated","affected_versions":">=2.5.0"},{"fix":"Wrap calls with `tenacity` or `backoff` to handle retries.","message":"The SDK does not automatically retry on rate limits (429 errors). You must implement your own retry logic or use an HTTP client with backoff.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'2.9.0':31 '3.11':39 '3.14':40 'adk':12 'ai':20,41 'assist':21,44 'build':16 'cadenc':36 'capabl':27 'current':28 'deploy':19 'develop':14 'enabl':13 'ibm':1,7,46 'ibm-watsonx':45 'orchestr':3,9,17,26,42 'python':4,10,38 'rapid':34 'releas':35 'requir':37 'sdk':5,11 'skill':43 'use':24 'version':29 'watsonx':2,8,25,47 'workflow':23","created_at":"2026-05-01T08:10:04.236501+00:00","updated_at":"2026-05-01T08:10:04.236501+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\nImportError: cannot import name 'Orchestrate' from 'ibm_watsonx_orchestrate' (/tmp/tmp6oxzupg7/venv/lib/python3.12/site-packages/ibm_watsonx_orchestrate/__init__.py)"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"2.11.0","cli_name":"","cli_version":null,"type":"library","homepage":"https://www.ibm.com/products/watsonx-orchestrate","github":null,"docs":null,"changelog":null,"pypi":"https://pypi.org/project/ibm-watsonx-orchestrate/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["llm-agents","workflow","ai-ml"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}