Installation

Requirements

Python 3.9+

Delve requires Python 3.9 or higher. Check your version with python --version

Installation Methods

PyPI (Recommended)
uv (Fast)
From Source

Install Delve from PyPI using pip:

pip install delve-taxonomy

This is the easiest method and works with any Python environment.

Using uv for fast dependency management:First, install uv if you haven’t already:

curl -LsSf https://astral.sh/uv/install.sh | sh

Then add Delve to your project:

uv add delve-taxonomy

Run Delve without activation:

uv run delve --version

Clone and install from source for development:Using uv:

git clone https://github.com/anthropics/delve.git
cd delve
uv venv
uv pip install -e .

Using pip:

git clone https://github.com/anthropics/delve.git
cd delve
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -e .

API Key Configuration

Anthropic API Key (Required)

Delve uses Claude models from Anthropic. You’ll need an API key:

Get an API Key

Set Environment Variable

Set your API key as an environment variable:

export ANTHROPIC_API_KEY="your-api-key-here"

Add this to your ~/.bashrc, ~/.zshrc, or ~/.profile to make it permanent.

Verify Installation

Check that Delve can access your API key:

delve --version

LangSmith API Key (Optional)

If you want to use LangSmith as a data source:

export LANGSMITH_API_KEY="your-langsmith-key"

Get your LangSmith API key from LangSmith.

Environment Variables

Create a .env file in your project directory for easy management:

.env

# Required
ANTHROPIC_API_KEY=your-anthropic-key

# Optional
LANGSMITH_API_KEY=your-langsmith-key
LITELLM_LOG=DEBUG  # Enable detailed LLM logging

Load it in your Python scripts:

from dotenv import load_dotenv
load_dotenv()

from delve import Delve
# API keys are automatically loaded from environment

Verify Installation

Test that everything is working:

# Check version
delve --version

# Get help
delve --help

# Test with sample data (if you have a CSV file)
delve run sample.csv --text-column text --sample-size 10

from delve import Delve

# This should work without errors
delve = Delve()
print("Delve is ready!")

Using with uv

If you installed with uv, you can run Delve without activating a virtual environment:

# CLI usage
uv run delve run data.csv --text-column text

# Python scripts
uv run python your_script.py

Using with Virtual Environments

If you prefer traditional virtual environments:

source venv/bin/activate
delve --version

venv\Scripts\activate
delve --version

Troubleshooting

Command not found: delve

Make sure you’ve installed Delve in your current environment:

pip install delve-taxonomy

If using a virtual environment, ensure it’s activated.

API key not found

Ensure your ANTHROPIC_API_KEY environment variable is set:

echo $ANTHROPIC_API_KEY

If empty, set it:

export ANTHROPIC_API_KEY="your-key"

Authentication failed

Your API key may be invalid or expired. Get a new one from the Anthropic Console.

Python version too old

Delve requires Python 3.9+. Upgrade your Python version:

python --version  # Check current version

Install Python 3.9+ from python.org

Next Steps

Quickstart

Run your first taxonomy generation

CLI Reference

Learn all CLI commands

SDK Reference

Explore the Python SDK

Examples

See code examples

Getting Started

Advanced Topics

CLI Usage

SDK Usage

Examples

Installation

Requirements

Python 3.9+

Installation Methods

API Key Configuration

Anthropic API Key (Required)

LangSmith API Key (Optional)

Environment Variables

Verify Installation

Using with uv

Using with Virtual Environments

Troubleshooting

Next Steps

Quickstart

CLI Reference

SDK Reference

Examples

​Requirements

Python 3.9+

​Installation Methods

​API Key Configuration

​Anthropic API Key (Required)

​LangSmith API Key (Optional)

​Environment Variables

​Verify Installation

​Using with uv

​Using with Virtual Environments

​Troubleshooting

​Next Steps

Quickstart

CLI Reference

SDK Reference

Examples

Requirements

Installation Methods

API Key Configuration

Anthropic API Key (Required)

LangSmith API Key (Optional)

Environment Variables

Verify Installation

Using with uv

Using with Virtual Environments

Troubleshooting

Next Steps