Ir para o conteúdo

Instalação

Instalação Básica

O DataFrameIt integra múltiplos provedores de LLM por LangChain ou pelos SDKs oficiais de ferramentas locais. Escolha o provider que deseja usar:

pip install dataframeit[openai]

Modelos: gpt-6-luna, gpt-6-sol, gpt-6-astra

pip install dataframeit[google]

Modelos: gemini-3.8-flash, gemini-3.6-flash, gemini-3.5-flash-lite

pip install dataframeit[anthropic]

Modelos: claude-sonnet-5, claude-opus-5-5, claude-haiku-4-5

pip install dataframeit[groq]

Modelos: openai/gpt-oss-120b, openai/gpt-oss-20b e outros do catálogo do Groq

pip install dataframeit[codex]
# ou
uv add "dataframeit[codex]"

O extra fixa o SDK Python oficial e seu runtime compatível. O DataFrameIt sempre usa esse runtime empacotado; uma instalação externa do comando codex não participa da execução. As versões do SDK e do runtime são fixadas exatamente, e o provider permanece experimental.

pip install dataframeit[claude-code]

O extra instala o Claude Agent SDK, que traz o Claude Code CLI. A autenticação é a do próprio Claude Code: as credenciais de um login feito numa instalação do Claude Code na máquina, ou ANTHROPIC_API_KEY. Ver Provedores.

pip install dataframeit[all]

Instala os providers OpenAI, Google, Anthropic, Groq e Claude Code, a busca web (Tavily e Exa), Polars e Excel. Enquanto experimental, o provider Codex não faz parte de all; instale dataframeit[codex] separadamente.

Outros providers do LangChain, como Cohere e Mistral, não têm extra: instale o pacote langchain-<provider> correspondente. Ver Provedores.

Com Busca Web (Opcional)

pip install dataframeit[search]       # Tavily
pip install dataframeit[search-exa]   # Exa
pip install dataframeit[search-all]   # os dois

A chave de API de cada provedor de busca está em Busca Web.

Com Polars (Opcional)

Se você usa Polars ao invés de Pandas, ou quer checkpoints em .parquet (o extra traz o pyarrow):

pip install dataframeit[openai,polars]

Com Excel (Opcional)

Para checkpoints em .xlsx ou ler arquivos Excel via read_df():

pip install dataframeit[excel]

Configuração de Autenticação

Configure as credenciais correspondentes ao seu provider:

export OPENAI_API_KEY="sua-chave-openai"

Obtenha sua chave em: OpenAI Platform

export GOOGLE_API_KEY="sua-chave-google"

Obtenha sua chave em: Google AI Studio

export ANTHROPIC_API_KEY="sua-chave-anthropic"

Obtenha sua chave em: Anthropic Console

export GROQ_API_KEY="sua-chave-groq"

Obtenha sua chave em: Groq Console

Se auth.json ainda não existir, instale o Codex CLI oficial e autentique uma vez:

codex --config cli_auth_credentials_store='"file"' login

O CLI externo serve somente para criar auth.json; a opção explícita evita armazenar as credenciais apenas no keyring do sistema. Esse é o único arquivo do estado persistente do Codex vinculado ao CODEX_HOME efêmero; o app-server ainda herda as variáveis de ambiente do processo. O DataFrameIt executa o runtime pinado pelo extra; não passe api_key ao dataframeit() para esse provider.

Verificando a Instalação

import dataframeit
print(dataframeit.__version__)

Se o provider escolhido não estiver instalado, o dataframeit() avisa antes de começar qual extra falta.

Próximo Passo

Agora que você instalou o DataFrameIt, veja o Início Rápido para criar seu primeiro projeto.