Altimate DataPilot CLI

0.2.3 verified Mon Apr 27 auth: no python

Altimate DataPilot CLI is a command-line tool designed to assist data teams with SQL quality, documentation, and data modeling workflows. Version 0.2.3 requires Python >=3.8. The package is actively maintained by Altimate AI.

pip install altimate-datapilot-cli

Common errors

error ModuleNotFoundError: No module named 'altimate_datapilot_cli' ↓

cause Incorrect import path; the module is named 'datapilot', not the hyphenated package name.

fix

Use: import datapilot

error AttributeError: module 'datapilot' has no attribute 'DataPilot' ↓

cause Outdated version of the package that did not export DataPilot as a public class.

fix

Upgrade to the latest version: pip install --upgrade altimate-datapilot-cli

error AuthenticationError: No API key provided ↓

cause Neither the environment variable DATAPILOT_API_KEY nor the api_key parameter was set.

fix

Set environment variable: export DATAPILOT_API_KEY='your_key' or pass api_key='your_key' to DataPilot().

Warnings

gotcha The package name on PyPI is 'altimate-datapilot-cli' (with hyphens), but the import module is 'datapilot' (no altimate prefix). Do not import from 'altimate_datapilot_cli' as that will raise ModuleNotFoundError. ↓

fix Use 'import datapilot' or 'from datapilot import DataPilot'

deprecated Some older versions (pre-0.2.0) used a different API endpoint that has been deprecated. Ensure you are using version 0.2.0 or later. ↓

fix Upgrade to the latest version: pip install --upgrade altimate-datapilot-cli

gotcha The API key must be provided either as an environment variable DATAPILOT_API_KEY or as a parameter. If both are missing, the client will throw an AuthenticationError. ↓

fix Set the environment variable or pass the api_key argument explicitly.

Imports

DataPilot
wrong
```
from altimate_datapilot_cli import DataPilot
```
correct
```
from datapilot import DataPilot
```
The correct import path uses the 'datapilot' module, not the package name with hyphens or underscores.

Quickstart

Initialize the DataPilot client with your API key and analyze a SQL statement.

from datapilot import DataPilot
import os

# Initialize with your API key
api_key = os.environ.get('DATAPILOT_API_KEY', 'your-api-key-here')
dp = DataPilot(api_key=api_key)

# Analyze a SQL file
result = dp.analyze_sql('SELECT * FROM orders WHERE id = 1')
print(result)