Installation

Requirements

Install via uv (recommended)

uv is a fast Python package and project manager:

uv add qualink

Install via pip

pip install qualink

Install from source

git clone https://github.com/gopidesupavan/qualink.git
cd qualink
uv sync

Dependencies

qualink has minimal dependencies:

Package Version Purpose
click ≥ 8.0 CLI framework for qualinkctl
datafusion ≥ 43.0.0 SQL query engine (Apache DataFusion)
pyarrow ≥ 15.0.0 Arrow columnar format support
pyyaml ≥ 6.0 YAML configuration parsing

Development Dependencies

For contributing or running tests:

uv sync --dev

This installs additional packages:

Package Purpose
pytest Test framework
pytest-asyncio Async test support

Verify Installation

After installing, verify that both the library and CLI are available:

qualinkctl --help
import qualink
from datafusion import SessionContext

# Create a DataFusion context
ctx = SessionContext()
print("qualink is ready! ✓")
💡 Tip

qualink works with any data source supported by DataFusion: CSV, Parquet, JSON, and in-memory Arrow tables.