Watson Developer Cloud Python SDK
Python client library to quickly get started with the various Watson Developer Cloud services.
Installation
To install, use pip
or easy_install
:
pip install --upgrade watson-developer-cloud
or
easy_install --upgrade watson-developer-cloud
Note: If you run into permission issues try:
sudo -H pip install --ignore-installed six watson-developer-cloud
For more details see #225
Examples
The examples folder has basic and advanced examples.
Getting the Service Credentials
Service credentials are required to access the APIs.
If you run your app in Bluemix, you don't need to specify the username and password. In that case, the SDK uses the VCAP_SERVICES
environment variable to load the credentials.
To run locally or outside of Bluemix you need the username
and password
credentials for each service. (Service credentials are different from your Bluemix account email and password.)
To create an instance of the service:
- Log in to Bluemix.
- Create an instance of the service:
- In the Bluemix Catalog, select the Watson service you want to use. For example, select the Conversation service.
- Type a unique name for the service instance in the Service name field. For example, type
my-service-name
. Leave the default values for the other options. - Click Create.
To get your service credentials:
Copy your credentials from the Service details page. To find the the Service details page for an existing service, navigate to your Bluemix dashboard and click the service name.
- On the Service Details page, click Service Credentials, and then View credentials.
- Copy
username
andpassword
.
Python Version
Tested on Python 2.7, 3.4, 3.5, and 3.6.
Changes for v1.0
Version 1.0 focuses on the move to programmatically-generated code for many of the services. See the changelog for the details.
Migration
This version includes many breaking changes as a result of standardizing behavior across the new generated services. Full details on migration from previous versions can be found here.
Known Issues
See issues.
Dependencies
- requests
pysolr
>=3.3, <4.0argparse
>=1.3.0pyOpenSSL
>=16.2.0python_dateutil
>= 2.5.3- responses for testing
Contributing
See CONTRIBUTING.md.
License
This library is licensed under the Apache 2.0 license.