Installation

Basic installation

pip install dataspoc-lens

This installs the core package with DuckDB, the CLI, interactive shell, and SQL transforms.

Requirements

• Python 3.10+
• DuckDB is installed automatically as a dependency

Optional extras

Install extras for additional capabilities:

# Cloud storage backends
pip install dataspoc-lens[s3]       # Amazon S3 support (s3fs)
pip install dataspoc-lens[gcs]      # Google Cloud Storage support (gcsfs)
pip install dataspoc-lens[azure]    # Azure Blob Storage support (adlfs)

# Notebooks
pip install dataspoc-lens[jupyter]  # JupyterLab with SQL magic
pip install dataspoc-lens[marimo]   # Marimo reactive notebooks

# AI and agents
pip install dataspoc-lens[ai]       # AI natural language queries (Anthropic, OpenAI)
pip install dataspoc-lens[mcp]      # MCP server for AI agent integration

# Everything
pip install dataspoc-lens[all]      # All extras included

Extras reference

Extra	What it adds	Use case
[s3]	s3fs	Query Parquet files in Amazon S3
[gcs]	gcsfs	Query Parquet files in Google Cloud Storage
[azure]	adlfs	Query Parquet files in Azure Blob Storage
[jupyter]	jupyterlab, jupysql, duckdb-engine, ipykernel, numpy, pandas	Interactive notebooks with %%sql magic
[marimo]	marimo, numpy, pandas	Reactive notebooks with Marimo
[ai]	anthropic, openai	Natural language queries via LLM
[mcp]	mcp	Model Context Protocol server for AI agents
[all]	All of the above	Full installation

Using uv

If you prefer uv as your package manager:

uv pip install dataspoc-lens
uv pip install dataspoc-lens[all]

Verify installation

dataspoc-lens --version

dataspoc-lens 0.2.0