Skip to main content

Documentation Index

Fetch the complete documentation index at: https://wildcampstudio.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Requirements

Python 3.9+

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

​
Installation Methods

​
API Key Configuration

​
Anthropic API Key (Required)

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

Get an API Key

Sign up and get your API key from the Anthropic Console
2

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.
3

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

​
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

​
Troubleshooting

Make sure you’ve installed Delve in your current environment:
pip install delve-taxonomy
If using a virtual environment, ensure it’s activated.
Ensure your ANTHROPIC_API_KEY environment variable is set:
echo $ANTHROPIC_API_KEY
If empty, set it:
export ANTHROPIC_API_KEY="your-key"
Your API key may be invalid or expired. Get a new one from the Anthropic Console.
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