Instalação

Requisitos

• Python 3.10 ou mais recente (3.11 e 3.12 também são suportados)
• pip, uv ou qualquer instalador compatível com PEP 517

Instalar via PyPI

pip install dataspoc-pipe

Ou com uv:

uv pip install dataspoc-pipe

Extras de armazenamento na nuvem

Por padrão, o Pipe grava no filesystem local. Para gravar em buckets na nuvem, instale o extra apropriado:

Extra	Provedor	Pacote backend
s3	Amazon S3	s3fs
gcs	Google Cloud Storage	gcsfs
azure	Azure Blob Storage	adlfs

# Amazon S3
pip install dataspoc-pipe[s3]

# Google Cloud Storage
pip install dataspoc-pipe[gcs]

# Azure Blob Storage
pip install dataspoc-pipe[azure]

# Multiple extras
pip install dataspoc-pipe[s3,gcs]

Extra do MCP server

Para usar o Pipe como servidor MCP para integração com agentes de IA:

pip install dataspoc-pipe[mcp]

Instalando Singer taps

Singer taps são pacotes separados. Instale os que você precisar:

# CSV files
pip install tap-csv

# PostgreSQL
pip install tap-postgres

# MySQL
pip install tap-mysql

# GitHub API
pip install tap-github

# Google Sheets (public)
# Built-in — no install needed

Cada tap é uma ferramenta CLI independente. O Pipe os executa como subprocessos, então eles só precisam estar disponíveis no seu PATH.

Dica

Use um ambiente virtual para manter as dependências dos taps isoladas:

python -m venv .venv
source .venv/bin/activate
pip install dataspoc-pipe[s3] tap-csv tap-postgres

Verificar a instalação

dataspoc-pipe --version

Saída esperada:

dataspoc-pipe 0.2.0

Próximos passos

Execute dataspoc-pipe init para criar o diretório de configuração e depois vá para o Quickstart para montar seu primeiro pipeline.