Getting started

Before you start writing your first application that connects to the 1010data Insights Platform, you need to install Python and download the Python SDK files.


You must have Python installed on your system. The 1010data Python SDK is available for Linux, macOS, and Windows (32-bit and 64-bit).

Windows 32-bit and 64-bit Windows 64-bit only Linux macOS
Python 3.7, Python 3.8, Python 3.9 Python 3.6, 3.10 Python 3.6, Python 3.7, Python 3.8, Python 3.9, Python 3.10 Python 3.7, Python 3.8, Python 3.9, Python 3.10
Note: macOS users should use the x86_64 version of Python.


You can download the Python SDK files from The dist folder contains a list of .whl files. Find the appropriate .whl file for your operating system.

Refer to the following table for the appropriate .whl file:

Description File name
Python 3.7 and 32-bit Windows Py1010-1.3.4-cp37-cp37m-win32.whl
Python 3.8 and 32-bit Windows Py1010-1.3.4-cp38-cp38-win32.whl
Python 3.9 and 32-bit Windows Py1010-1.3.4-cp39-cp39-win32.whl
Python 3.6 and 64-bit Windows Py1010-1.3.4-cp36-cp36m-win_amd64.whl
Python 3.7 and 64-bit Windows Py1010-1.3.4-cp37-cp37m-win_amd64.whl
Python 3.8 and 64-bit Windows Py1010-1.3.4-cp38-cp38-win_amd64.whl
Python 3.9 and 64-bit Windows Py1010-1.3.4-cp39-cp39-win_amd64.whl
Python 3.10 and 64-bit Windows Py1010-1.3.4-cp310-cp310-win_amd64.whl
Python 3.6 and Linux Py1010-1.3.4-cp36-cp36m-linux_x86_64.whl
Python 3.6 and any Linux Py1010-1.3.4-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Python 3.7 and Linux Py1010-1.3.4-cp37-cp37m-linux_x86_64.whl
Python 3.7 and any Linux Py1010-1.3.4-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Python 3.8 and Linux Py1010-1.3.4-cp38-cp38-linux_x86_64.whl
Python 3.8 and any Linux Py1010-1.3.4-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Python 3.9 and Linux Py1010-1.3.4-cp39-cp39-linux_x86_64.whl
Python 3.9 and any Linux Py1010-1.3.4-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Python 3.10 and Linux Py1010-1.3.4-cp310-cp310-linux_x86_64.whl
Python 3.10 and any Linux Py1010-1.3.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Python 3.7 and macOS Py1010-1.3.4-cp37-cp37m-macosx_10_15_x86_64.whl
Python 3.8 and macOS Py1010-1.3.4-cp38-cp38-macosx_10_15_x86_64.whl
Python 3.9 and macOS Py1010-1.3.4-cp39-cp39-macosx_10_15_x86_64.whl
Python 3.10 and macOS Py1010-1.3.4-cp310-cp310-macosx_10_15_x86_64.whl
Note: The manylinux2010 versions are preferred if you are running Linux of any sort. If you run the regular linux version and it doesn't work, use manylinux2010.
After you identify the appropriate .whl file, install py1010 in your current Python environment. For example, you would install py1010 for Python 3.8 and Linux as follows:
pip install Py1010-1.3.4-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Note: You may need to have administrator/root privileges to do this.
You would install py1010 for Python 3.8 and Linux as a user alone as follows:
pip install --user Py1010-1.3.4-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Alternatively, you can copy the appropriate library files from the bin folder of the Python SDK to your working directory. Choose the folder that contains library files that match your operating system:

Operating System Version to use
Windows - 32-bit win32
Windows - 64-bit win64
Linux lin64
macOS osx

Using the single sign-on (SSO) feature

If you want to use the SSO feature of the Python SDK, you also need to copy the file sso_login to any directory on the PATH. Check your PATH environment variable for a list of directories by typing echo %PATH% (Windows) or echo $PATH (macOS/Linux) on the command line.

Example projects

The examples folder contains the following examples:
Prints the columns of a table one at a time.
Exports results to a pandas DataFrame.
Prints the rows of a table one at a time.
Displays a complex web server example using multiple threads.
Uses two threads to create two session objects, retrieves information from two tables, and downloads the data into two separate files.