Prerequisites

64-bit Python 3.8 or later.

A Python virtual environment. The recommended workflow using system venv is shown below. If you have uv installed, an alternative workflow is provided.

# Recommended (system venv):
python3 -m venv .venv
. .venv/bin/activate
python -m pip install --upgrade pip
pip install teradatasql

# Alternative (uv):
uv venv .venv
uv pip install teradatasql

Note

teradatasql package runs on Windows, macOS (10.14 Mojave or later) and Linux. For Linux, currently only Linux x86-64 architecture is supported.

Access to a Teradata instance. Currently driver is supported for use with Teradata Database 16.10 and later releases.

Note

If you need a test instance of Teradata, you can provision one for free at https://www.teradata.com/try