Learn how to install and get started with the Python client library for CrateDB.

The CrateDB Python client is available as package crate on PyPI.

To install the most recent driver version, run:

pip install --upgrade crate

After that is done, you can import the library, like so:

>>> from crate import client

Python provides a REPL, also known as an interactive language shell. It's a handy way to experiment with code and try out new libraries. We recommend IPython, which you can install, like so:

pip install ipython

Once installed, you can start it up, like this:

ipython

From there, try importing the CrateDB Python client library and seeing how far you get with the built-in help() function (that can be called on any object), IPython's autocompletion, and many other features.

.. SEEALSO::

   `The IPython Documentation`_

There are many ways to add the crate package as a dependency to your project. All of them work equally well. Please note that you may want to employ package version pinning in order to keep the environment of your project stable and reproducible, achieving repeatable installations.

Learn how to :ref:`connect to CrateDB <connect>`.