Installation

The Python QuestDB client does not have any additional run-time dependencies and will run on any version of Python >= 3.8 on most platforms and architectures.

You can install it (or update it) globally by running:

python3 -m pip install -U questdb

Or, from within a virtual environment:

pip install questdb

If you’re using poetry, you can add questdb as a dependency:

poetry add questdb

Note that the questdb.ingress.Buffer.dataframe() and the questdb.ingress.Sender.dataframe() methods also require the following dependencies to be installed:

  • pandas

  • pyarrow

  • numpy

Verifying the Installation

If you want to check that you’ve installed the wheel correctly, you can run the following statements from a python3 interactive shell:

>>> import questdb.ingress
>>> buf = questdb.ingress.Buffer()
>>> buf.row('test', symbols={'a': 'b'})
<questdb.ingress.Buffer object at 0x104b68240>
>>> str(buf)
'test,a=b\n'

If you also want to if check you can serialize from Pandas (which requires additional dependencies):

>>> import questdb.ingress
>>> import pandas as pd
>>> df = pd.DataFrame({'a': [1, 2]})
>>> buf = questdb.ingress.Buffer()
>>> buf.dataframe(df, table_name='test')
>>> str(buf)
'test a=1i\ntest a=2i\n'