Skip to content

Installation

Basic Installation

DataFrameIt integrates multiple LLM providers through LangChain or official SDKs for local tools. Choose the provider you want to use:

pip install dataframeit[openai]

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

pip install dataframeit[google]

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

pip install dataframeit[anthropic]

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

pip install dataframeit[groq]

Models: openai/gpt-oss-120b, openai/gpt-oss-20b and others from the Groq catalog

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

This extra pins the official Python SDK and its compatible runtime. DataFrameIt always uses that bundled runtime; an external codex command does not participate in execution. The SDK and runtime versions are pinned exactly, and the provider remains experimental.

pip install dataframeit[claude-code]

The extra installs the Claude Agent SDK, which ships the Claude Code CLI. Authentication is Claude Code's own: the credentials of a login done with a Claude Code installation on the machine, or ANTHROPIC_API_KEY. See Providers.

pip install dataframeit[all]

Installs the OpenAI, Google, Anthropic, Groq and Claude Code providers, web search (Tavily and Exa), Polars and Excel. While experimental, the Codex provider is not included in all; install dataframeit[codex] separately.

Other LangChain providers, such as Cohere and Mistral, have no extra: install the corresponding langchain-<provider> package. See Providers.

With Web Search (Optional)

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

The API key for each search provider is described in Web Search.

With Polars (Optional)

If you use Polars instead of Pandas, or want .parquet checkpoints (the extra brings pyarrow):

pip install dataframeit[openai,polars]

With Excel (Optional)

For .xlsx checkpoints or reading Excel files via read_df():

pip install dataframeit[excel]

Authentication Configuration

Configure the credentials for your provider:

export OPENAI_API_KEY="your-openai-key"

Get your key at: OpenAI Platform

export GOOGLE_API_KEY="your-google-key"

Get your key at: Google AI Studio

export ANTHROPIC_API_KEY="your-anthropic-key"

Get your key at: Anthropic Console

export GROQ_API_KEY="your-groq-key"

Get your key at: Groq Console

If auth.json does not exist yet, install the official Codex CLI and authenticate once:

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

The external CLI is used only to create auth.json; the explicit option prevents the credentials from being stored only in the system keyring. This is the only file from Codex's persistent state linked into the ephemeral CODEX_HOME; the app server still inherits the process environment variables. DataFrameIt executes the runtime pinned by the extra; do not pass api_key to dataframeit() for this provider.

Verifying Installation

import dataframeit
print(dataframeit.__version__)

If the chosen provider is not installed, dataframeit() tells you which extra is missing before it starts.

Next Step

Now that you've installed DataFrameIt, see the Quickstart to create your first project.