Instalação

Instalação básica

pip install dataspoc-lens

Isso instala o pacote principal com DuckDB, a CLI, shell interativo e transformações SQL.

Requisitos

Python 3.10+
DuckDB é instalado automaticamente como dependência

Extras opcionais

Instale extras para funcionalidades adicionais:

# 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

Referência de extras

Extra	O que adiciona	Caso de uso
`[s3]`	`s3fs`	Consultar arquivos Parquet no Amazon S3
`[gcs]`	`gcsfs`	Consultar arquivos Parquet no Google Cloud Storage
`[azure]`	`adlfs`	Consultar arquivos Parquet no Azure Blob Storage
`[jupyter]`	`jupyterlab`, `jupysql`, `duckdb-engine`, `ipykernel`, `numpy`, `pandas`	Notebooks interativos com `%%sql` magic
`[marimo]`	`marimo`, `numpy`, `pandas`	Notebooks reativos com Marimo
`[ai]`	`anthropic`, `openai`	Consultas em linguagem natural via LLM
`[mcp]`	`mcp`	Servidor Model Context Protocol para agentes de IA
`[all]`	Todos os acima	Instalação completa

Usando uv

Se você prefere o uv como gerenciador de pacotes:

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

Verificar a instalação

dataspoc-lens --version

dataspoc-lens 0.2.0