Skip to main content

​
Installation

Install the Respan Python SDK using pip: 
pip install respan

​
Authentication

First, you’ll need to get your API key from the Respan dashboard. Then, initialize the client: 
from respan import Respan

# Initialize the client
client = Respan(api_key="your-api-key-here")

​
Basic Usage

​
Creating a Log

# Create a log entry
log = client.logs.create(
    messages=[
        {"role": "user", "content": "Hello, world!"},
        {"role": "assistant", "content": "Hi there! How can I help you today?"}
    ],
    model="gpt-3.5-turbo",
    prompt_tokens=10,
    completion_tokens=15,
    total_tokens=25
)

print(f"Created log with ID: {log.id}")

​
Working with Datasets

# Create a dataset
dataset = client.datasets.create(
    name="My First Dataset",
    description="A sample dataset for testing"
)

# Add logs to the dataset
client.datasets.add_logs_to_dataset(
    dataset_id=dataset.id,
    log_ids=[log.id]
)

​
Managing Prompts

# Create a prompt
prompt = client.prompts.create(
    name="Greeting Prompt",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "{{user_input}}"}
    ]
)

# Create a version of the prompt
version = client.prompts.create_version(
    prompt_id=prompt.id,
    messages=[
        {"role": "system", "content": "You are a very helpful assistant."},
        {"role": "user", "content": "{{user_input}}"}
    ],
    version_name="v1.1"
)

​
Next Steps