labdados — SDK Python

Cliente oficial dos serviços do escritório de apoio do LabDados (FGV Direito SP)

O que é

labdados é o pacote Python para usar os serviços do escritório de apoio do LabDados direto de notebooks e scripts. Ele cobre as tarefas que aparecem o tempo todo em pesquisa empírica em direito:

Função O que faz Tempo típico
labdados.ocr Extrai texto de PDFs (nativos ou escaneados) ~0,5s/página
labdados.transcricao Transcreve áudio com diarização opcional ~1/30 da duração
labdados.estruturacao Extrai campos JSON de textos com LLM (9 modelos) ~2s/documento
labdados.anonimizacao Detecta e mascara dados pessoais segundos
labdados.embeddings Transforma textos em vetores (busca semântica, agrupamento) segundos
labdados.analise_viabilidade Estima volume de processos antes de coletar 30s–5min

Cada função roda em dois modos:

  • Nuvem (default) — processa na infra do escritório, com os modelos do Azure AI Foundry da FGV. Rápido em volume alto, dispensa setup local. Exige uma API key (por enquanto, de uso interno da equipe LabDados).
  • Local (local=True) — processa no próprio computador. Útil para testes, dados sensíveis que não saem do laptop, ou quando você não tem uma API key ainda.

Instalação

# Mínimo (modo nuvem para os 4 serviços)
pip install labdados

# Para modo local — adicione apenas os serviços que vai usar
pip install labdados[ocr]               # PyMuPDF + Tesseract
pip install labdados[transcricao]       # faster-whisper
pip install labdados[estruturacao]      # cliente OpenAI-compat (Ollama, Azure, OpenAI)
pip install labdados[viabilidade]       # juscraper + jinja2

# Tudo
pip install labdados[all]

“Hello, world”

import labdados

labdados.ocr(
    arquivos="meus_pdfs/",
    api_key="sk_lab_...",
    saida="resultados/",
)

Em 5 minutos, os PDFs viram .zip em resultados/ (modo nuvem). Sem API key ainda? Adicione local=True (precisa do extra [ocr] instalado).

Como pedir uma API key

A API key é gerada no fluxo de consultoria do portal — acesse o formulário de pedido de chave. Você descreve o uso, a equipe revisa e te envia a chave por e-mail (uma única vez — guarde com cuidado).

Próximos passos