Install Tabsdata

Tabsdata requires the tabsdata python package, which is installable through pip and requires no admin or root privileges.

Requirements

• Machine with a supported OS
  • Linux (x86)
  • macOS (Apple Silicon/ARM64)
  • Windows (x86)
• Python 3.12
• An LLM API key from Anthropic or OpenAI (Required for AI features)

Create a Python virtual environment

Using a virtual environment provides a layer of isolation and prevents interference from other python environments on your machine.

macOS / Linux

conda

conda create -n tabsdata python=3.12 -y
conda activate tabsdata

uv

uv venv --python 3.12 .venv
source .venv/bin/activate

pyenv

pyenv install 3.12
pyenv local 3.12
python -m venv .venv
source .venv/bin/activate

venv

python3 -m venv .venv
source .venv/bin/activate

Windows (PowerShell)

conda

conda create -n tabsdata python=3.12 -y
conda activate tabsdata

uv

uv venv --python 3.12 .venv
.venv\Scripts\activate

pyenv

pyenv install 3.12
pyenv local 3.12
python -m venv .venv
.venv\Scripts\activate

venv

python -m venv .venv
.venv\Scripts\activate

Temporary installation requirements for 2.0.0

warning

Tabsdata 2.0.0 is temporarily hosted on the Tabsdata package index rather than PyPI due to an operational upload limit. Until 2.0.0 is available on PyPI, configure pip and uv to use the Tabsdata index and explicitly install version 2.0.0.

macOS / Linux

export PIP_EXTRA_INDEX_URL=https://pypi.tabsdata.com/simple/
export UV_INDEX=https://pypi.tabsdata.com/simple/
export UV_INDEX_STRATEGY=unsafe-best-match

Windows (PowerShell)

$env:PIP_EXTRA_INDEX_URL = "https://pypi.tabsdata.com/simple/"
$env:UV_INDEX = "https://pypi.tabsdata.com/simple/"
$env:UV_INDEX_STRATEGY = "unsafe-best-match"

Keep these environment variables set until the Tabsdata Instance has been created and run successfully. tdkserver quickstart creates a separate Python environment within the Tabsdata server and also needs access to the Tabsdata index.

These additional steps will be removed once Tabsdata 2.0.0 is available on PyPI.

Install Tabsdata

warning

Until 2.0.0 is fully hosted on pypi, please make sure to specify ==2.0.0 and install tabsdata-agent to enable AI features. Future releases will not have this requirement

uv

uv pip install "tabsdata[all]"==2.0.0 tabsdata-agent==2.0.0

pip

pip install "tabsdata[all]"==2.0.0 tabsdata-agent==2.0.0

Some Notes on Tabsdata Server Providers

Tabsdata runs on a Kubernetes cluster, and this install uses kminus: a lightweight Kubernetes that runs pods as native processes in your Python environment instead of Docker containers, so it needs no root or admin access. The --provider option allows configuring through Amazon EKS instead. To run Tabsdata on AWS EKS, please explore Install on EKS for more info.