These samples will show you how to get up and running using the Python SDKs for various Cognitive Services services. They'll cover a few rudimentary use cases and hopefully express best practices for interacting with the data from these APIs.

This project framework provides examples for the following services:

We provide several meta-packages to help you install several packages at a time. Please note that meta-packages are only recommended for development purpose. It's recommended in production to always pin specific version of individual packages.

1. A cognitive services API key with which to authenticate the SDK's calls. Create a new Azure account, and try Cognitive Services for free.

Subscription keys are usually per service. For example, the subscription key for Spell Check will not be the same than Custom Search. Read the previous sign up link or the Azure portal for details on subscription keys.

1. If you don't already have it, install Python.

   This sample (and the SDK) is compatible with Python 2.7, 3.3, 3.4, 3.5 and 3.6.

2. General recommendation for Python development is to use a Virtual Environment. For more information, see https://docs.python.org/3/tutorial/venv.html

   Install and initialize the virtual environment with the "venv" module on Python 3 (you must install virtualenv for Python 2.7):

   python -m venv mytestenv # Might be "python3" or "py -3.6" depending on your Python installation
   cd mytestenv
   source bin/activate      # Linux shell (Bash, ZSH, etc.) only
   ./scripts/activate       # PowerShell only
   ./scripts/activate.bat   # Windows CMD only

1. Clone the repository.

   git clone https://github.com/Azure-Samples/cognitive-services-python-sdk-samples.git

2. Install the dependencies using pip.

   cd cognitive-services-python-sdk-samples
   pip install -r requirements.txt

3. Set up the environment variables with corresponding keys to execute samples of interest

A demo app is included to show how to use the project.

To run the complete demo, execute python example.py

To run each individual demo, point directly to the file. For example (i.e. not complete list):

1. python samples/language/spellcheck_samples.py
2. python samples/search/entity_search_samples.py
3. python samples/search/video_search_samples.py
4. python samples/vision/inkrecognizer_sample.py

To see the code of each example, simply look at the examples in the Samples folder. They are written to be isolated in scope so that you can see only what you're interested in.

• https://docs.microsoft.com/python/api/overview/azure/cognitive-services
• https://github.com/Azure/azure-sdk-for-python