SideSeat

https://sideseat.ai/docs
Admin
SideSeat is a local observability workbench for AI agents that captures LLM calls, tool executions,...
Tokens:99,679
Snippets:1,006
Trust Score:4.1
Update:1 month ago
Show doc for...
Tokens:
Raw
### Install Dependencies (Quick Start)

Source: https://sideseat.ai/docs/integrations/frameworks/strands

Install the required packages using pip or uv.

```bash
pip install strands-agents sideseat
```

```bash
uv add strands-agents sideseat
```

--------------------------------

### Quick Start: initialize SideSeat and run an agent

Source: https://sideseat.ai/docs/sdks/python

Add two lines at the top of your entry point to start streaming runs to SideSeat at http://localhost:5388. The example uses the Strands framework.

```python
from sideseat import SideSeat, Frameworks
from strands import Agent


SideSeat(framework=Frameworks.Strands)


agent = Agent()
response = agent("Hello!")
```

--------------------------------

### Install browser-use and sideseat

Source: https://sideseat.ai/docs/integrations/frameworks/other

Install the browser-use package and sideseat.

```bash
pip install browser-use sideseat
```

--------------------------------

### Install sideseat with uv

Source: https://sideseat.ai/docs/sdks/python

Install the SideSeat Python SDK using uv.

```bash
uv add sideseat
```

--------------------------------

### Install sideseat with optional extras

Source: https://sideseat.ai/docs/sdks/python

Install the SideSeat Python SDK with optional framework instrumentors. Extras can be combined freely; 'all' installs every extra.

```bash
pip install "sideseat[langchain]"
pip install "sideseat[openai,anthropic]"   # combine freely
pip install "sideseat[all]"                # every extra below
```

--------------------------------

### Install and Run SideSeat

Source: https://sideseat.ai/docs/reference/cli

Instructions for installing the CLI globally or running it as a one-off command.

```bash
# Global install (recommended)
npm install -g sideseat
sideseat


# One-off run
npx sideseat
```

--------------------------------

### Install sideseat with poetry

Source: https://sideseat.ai/docs/sdks/python

Install the SideSeat Python SDK using poetry.

```bash
poetry add sideseat
```

--------------------------------

### Install sideseat with pip

Source: https://sideseat.ai/docs/sdks/python

Install the SideSeat Python SDK using pip.

```bash
pip install sideseat
```

--------------------------------

### init() usage examples

Source: https://sideseat.ai/docs/sdks/typescript/init

Examples showing minimal initialization, initialization with custom options, and environment-based configuration.

```typescript
import { init, Frameworks } from '@sideseat/sdk';


// Minimal
await init({ framework: Frameworks.VercelAI });


// With options
const client = await init({
  framework: Frameworks.Strands,
  endpoint: 'http://sideseat.example.com:5388',
  projectId: 'my-project',
  serviceName: 'my-ai-agent',
  debug: true
});


// Environment-based
await init({ framework: Frameworks.VercelAI, debug: process.env.NODE_ENV !== 'production' });
```

--------------------------------

### Install dependencies with pip or uv

Source: https://sideseat.ai/docs/integrations/frameworks/openai-agents

Install the required packages for the SideSeat SDK integration.

```bash
pip install openai-agents "sideseat[openai-agents]"
```

```bash
uv add openai-agents "sideseat[openai-agents]"
```

--------------------------------

### Install @sideseat/sdk via pnpm

Source: https://sideseat.ai/docs/sdks/typescript

Install the SDK using the pnpm package manager.

```bash
pnpm add @sideseat/sdk
```

--------------------------------

### Install AgentScope and SideSeat

Source: https://sideseat.ai/docs/integrations/frameworks/other

Install the required AgentScope and SideSeat packages.

```bash
pip install agentscope sideseat
```

--------------------------------

### Install @sideseat/sdk via npm

Source: https://sideseat.ai/docs/sdks/typescript

Install the SDK using the npm package manager.

```bash
npm install @sideseat/sdk
```

--------------------------------

### Start SideSeat with authentication (default)

Source: https://sideseat.ai/docs/reference/auth

Starts the server with authentication enabled. The output shows the local URL with a bootstrap token.

```bash
# Start with authentication (default)
sideseat start


# Output:
#   SideSeat v1.x
#   ➜  Local: http://127.0.0.1:5388/ui?token=abc123...
```

--------------------------------

### Install @sideseat/sdk via yarn

Source: https://sideseat.ai/docs/sdks/typescript

Install the SDK using the yarn package manager.

```bash
yarn add @sideseat/sdk
```

--------------------------------

### Install SideSeat LangChain extra with uv

Source: https://sideseat.ai/docs/integrations/frameworks/other

Install the langchain, langchain-openai, and sideseat[langchain] packages using uv.

```bash
uv add langchain langchain-openai "sideseat[langchain]"
```

--------------------------------

### Install AG2 and SideSeat

Source: https://sideseat.ai/docs/integrations/frameworks/other

Install the required AG2 and SideSeat packages.

```bash
pip install "ag2[openai]<1.0" "sideseat[ag2]"
```

--------------------------------

### Install OpenTelemetry SDK via uv

Source: https://sideseat.ai/docs/integrations/frameworks/other

Install the required OpenTelemetry SDK and OTLP exporter packages using uv.

```bash
uv add opentelemetry-sdk opentelemetry-exporter-otlp
```

--------------------------------

### Install Dependencies (Without SDK)

Source: https://sideseat.ai/docs/integrations/frameworks/strands

Install the Strands agents package with OTLP support.

```bash
pip install 'strands-agents[otel]'
```

```bash
uv add 'strands-agents[otel]'
```

--------------------------------

### Install Claude Agent SDK

Source: https://sideseat.ai/docs

Installation commands for the Claude Agent SDK.

```bash
pip install claude-agent-sdk
```

```bash
uv add claude-agent-sdk
```

--------------------------------

### Install dependencies with uv

Source: https://sideseat.ai/docs/integrations/frameworks/langgraph

Install the required Python packages for the SideSeat SDK integration using uv.

```bash
uv add langgraph langchain-openai "sideseat[langgraph]"
```

--------------------------------

### Install Bedrock dependencies

Source: https://sideseat.ai/docs

Install the required packages for Bedrock using pip or uv.

```bash
pip install "sideseat[aws]" boto3
```

```bash
uv add "sideseat[aws]" boto3
```

--------------------------------

### Install sideseat with pip or uv

Source: https://sideseat.ai/docs/sdks/python

Install the SideSeat Python SDK using pip or uv. The uv command is an alternative to pip.

```bash
pip install sideseat
# or
uv add sideseat
```

--------------------------------

### Install Google ADK Dependencies

Source: https://sideseat.ai/docs

Installation commands for the required packages using pip or uv.

```bash
pip install agent-framework opentelemetry-sdk opentelemetry-exporter-otlp
```

```bash
uv add agent-framework opentelemetry-sdk opentelemetry-exporter-otlp
```

--------------------------------

### Install dependencies with pip

Source: https://sideseat.ai/docs/integrations/frameworks/langgraph

Install the required Python packages for the SideSeat SDK integration.

```bash
pip install langgraph langchain-openai "sideseat[langgraph]"
```

--------------------------------

### Install SideSeat PydanticAI extra with uv

Source: https://sideseat.ai/docs/integrations/frameworks/other

Install the pydantic-ai and sideseat[pydantic-ai] packages using uv.

```bash
uv add pydantic-ai "sideseat[pydantic-ai]"
```

--------------------------------

### Install dependencies without SideSeat SDK (uv)

Source: https://sideseat.ai/docs/integrations/frameworks/langgraph

Install the required packages for manual OpenTelemetry and OpenInference instrumentation using uv.

```bash
uv add langgraph langchain-openai openinference-instrumentation-langchain opentelemetry-exporter-otlp
```

--------------------------------

### Install Google ADK Dependencies

Source: https://sideseat.ai/docs

Installation commands for Google ADK and OpenTelemetry using pip or uv.

```bash
pip install google-adk opentelemetry-sdk opentelemetry-exporter-otlp
```

```bash
uv add google-adk opentelemetry-sdk opentelemetry-exporter-otlp
```

--------------------------------

### Install AutoGen dependencies via uv

Source: https://sideseat.ai/docs/integrations/frameworks/other

Install the required packages for AutoGen integration using uv.

```bash
uv add autogen-agentchat "autogen-ext[openai]" "sideseat[autogen]"
```

--------------------------------

### Install OpenTelemetry SDK via pip

Source: https://sideseat.ai/docs/integrations/frameworks/other

Install the required OpenTelemetry SDK and OTLP exporter packages using pip.

```bash
pip install opentelemetry-sdk opentelemetry-exporter-otlp
```

--------------------------------

### Install Google GenAI dependencies

Source: https://sideseat.ai/docs

Install the required packages for Google GenAI using pip or uv.

```bash
pip install "sideseat[google-genai]" google-genai
```

```bash
uv add "sideseat[google-genai]" google-genai
```

--------------------------------

### Install SideSeat LangChain extra with pip

Source: https://sideseat.ai/docs/integrations/frameworks/other

Install the langchain, langchain-openai, and sideseat[langchain] packages using pip.

```bash
pip install langchain langchain-openai "sideseat[langchain]"
```

--------------------------------

### List Traces Examples

Source: https://sideseat.ai/docs/reference/api/traces

Common cURL examples for listing recent traces, filtering by session, and filtering by environment.

```bash
# List recent traces
curl "http://localhost:5388/api/v1/project/default/otel/traces?page=1&limit=20"


# Filter by session
curl "http://localhost:5388/api/v1/project/default/otel/traces?session_id=session-789"


# Filter by environment
curl "http://localhost:5388/api/v1/project/default/otel/traces?environment=development"
```

--------------------------------

### Install dependencies without SideSeat SDK (pip)

Source: https://sideseat.ai/docs/integrations/frameworks/langgraph

Install the required packages for manual OpenTelemetry and OpenInference instrumentation.

```bash
pip install langgraph langchain-openai openinference-instrumentation-langchain opentelemetry-exporter-otlp
```

--------------------------------

### get_tracer(name)

Source: https://sideseat.ai/docs/sdks/python/telemetry

Gets an OpenTelemetry tracer by name. Returns a Tracer object that can be used to start spans.

```APIDOC
## get_tracer(name)

### Description
Gets an OpenTelemetry tracer by name. Returns a Tracer object that can be used to start spans.

### Method
`get_tracer(name)`

### Parameters
- **name** (str) - Required - Tracer name

### Returns
`Tracer`

### Example
```python
client = SideSeat()
tracer = client.get_tracer("my-module")

with tracer.start_as_current_span("operation"):
    # ... work ...
    pass
```
```

--------------------------------

### GET /api/v1/project/{project}/otel/traces - Filter traces by framework and start time

Source: https://sideseat.ai/docs/reference/otel

Retrieves traces that belong to either of two frameworks and have a start_time on or after a given date.

```APIDOC
## GET /api/v1/project/{project}/otel/traces

### Description
Retrieves traces that match multiple filter criteria: framework must be any of the given values, and start_time must be greater than or equal to the specified datetime.

### Method
GET

### Endpoint
/api/v1/project/{project}/otel/traces

### Parameters
#### Query Parameters
- **filters** (string) - Required - URL-encoded JSON array of filter objects. Each object has type, column, operator, and value (except for null type).

### Request Example
curl -G "http://localhost:5388/api/v1/project/default/otel/traces" \
  --data-urlencode 'filters=[
    {"type":"string_options","column":"framework","operator":"any of","value":["StrandsAgents","ClaudeAgentSDK"]},
    {"type":"datetime","column":"start_time","operator":">=","value":"2026-01-01T00:00:00Z"}
  ]'

### Response
#### Success Response (200)
- **traces** (array) - List of trace objects matching the filter.

#### Response Example
(No explicit response example provided in source.)
```

--------------------------------

### Start SideSeat with npx sideseat

Source: https://sideseat.ai/docs/integrations/frameworks/langgraph

Run this command to start SideSeat locally. It must be running before you add telemetry.

```bash
npx sideseat
```

--------------------------------

### Install OpenTelemetry and AI SDK dependencies

Source: https://sideseat.ai/docs/integrations/frameworks/vercel-ai

Installs the required packages for OpenTelemetry tracing, the AI SDK, and the Amazon Bedrock provider.

```bash
npm install @opentelemetry/sdk-node @opentelemetry/exporter-trace-otlp-http ai @ai-sdk/otel @ai-sdk/amazon-bedrock
```

--------------------------------

### Streaming: Capture Streamed Responses

Source: https://sideseat.ai/docs/integrations/providers/vertex-ai

Streaming responses are fully captured, including token counts aggregated from stream chunks. Uses the same SideSeat initialization and Vertex AI setup as the quick start.

```python
import vertexai
from vertexai.generative_models import GenerativeModel
from sideseat import SideSeat, Frameworks


SideSeat(framework=Frameworks.VertexAI)


vertexai.init(project="your-project", location="us-central1")
model = GenerativeModel("gemini-2.5-flash")


for chunk in model.generate_content("Explain quantum computing.", stream=True):
    print(chunk.text, end="", flush=True)
```

--------------------------------

### Configure Python telemetry

Source: https://sideseat.ai/docs/integrations/frameworks/claude-agent-sdk

Example showing how to initialize the client and configure OTLP environment variables for Python.

```python
import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions
from sideseat import SideSeat, Frameworks


client = SideSeat(framework=Frameworks.ClaudeAgentSDK)


# Passed to the CLI subprocess, which exports OTLP directly.
OTEL_ENV = {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    # Span tracing is beta and off without this flag.
    "CLAUDE_CODE_ENHANCED_TELEMETRY_BETA": "1",
    # Second beta tier. Without these two the Messages tab stays empty:
    # assistant reply text exists nowhere else on the trace.
    "ENABLE_BETA_TRACING_DETAILED": "1",
    "BETA_TRACING_ENDPOINT": "http://localhost:5388/otel/default",
    "OTEL_TRACES_EXPORTER": "otlp",
    "OTEL_EXPORTER_OTLP_TRACES_PROTOCOL": "http/protobuf",
    "OTEL_EXPORTER_OTLP_TRACES_ENDPOINT": "http://localhost:5388/otel/default/v1/traces",
    # Content is redacted by default.
    "OTEL_LOG_USER_PROMPTS": "1",
    "OTEL_LOG_TOOL_DETAILS": "1",
}




async def main():
    options = ClaudeAgentOptions(env=OTEL_ENV, allowed_tools=["Read", "Glob"])
    # client.trace() parents the run: the SDK injects TRACEPARENT.
    with client.trace("agent-run"):
        async for message in query(prompt="What is 2+2?", options=options):
            print(message)




asyncio.run(main())
```

--------------------------------

### Concurrent span creation with SideSeat

Source: https://sideseat.ai/docs/sdks/python/telemetry

Shows how to create spans concurrently from multiple threads using the SideSeat client. The example creates 10 threads, each calling client.span("worker") within a worker function, then starts and joins them before calling client.shutdown().

```python
import threading


client = SideSeat()


def worker():
    with client.span("worker"):
        # ... work ...
        pass


threads = [threading.Thread(target=worker) for _ in range(10)]
for t in threads:
    t.start()
for t in threads:
    t.join()


client.shutdown()
```

--------------------------------

### Use SideSeat with LlamaIndex via OpenInference instrumentor

Source: https://sideseat.ai/docs/integrations/frameworks/other

Initialize SideSeat with auto_instrument=False and instrument LlamaIndex using LlamaIndexInstrumentor. The comment explains that without a LlamaIndex branch, the SDK would otherwise auto-detect from installed packages. The example loads documents, builds an index, and queries it.

```python
from sideseat import SideSeat
from openinference.instrumentation.llama_index import LlamaIndexInstrumentor
from llama_index.core import VectorStoreIndex, SimpleDirectoryReader


# auto_instrument=False: without a LlamaIndex branch the SDK would otherwise instrument
# whichever framework it happens to auto-detect from your installed packages.
client = SideSeat(auto_instrument=False)
LlamaIndexInstrumentor().instrument(tracer_provider=client.telemetry.tracer_provider)


documents = SimpleDirectoryReader("data").load_data()
index = VectorStoreIndex.from_documents(documents)
query_engine = index.as_query_engine()


response = query_engine.query("What is this about?")
print(response)
```

--------------------------------

### Initialize and use StorageManager

Source: https://sideseat.ai/docs/reference/storage

Demonstrates initializing the storage manager, resolving various directory paths, checking for fallback mode, and reading user configuration files.

```rust
use sideseat_server::core::{StorageManager, StorageType, DataSubdir};


// Initialize storage
let storage = StorageManager::init().await?;


// Get current working directory
let cwd = storage.work_dir();
println!("Started from: {:?}", cwd);


// Get data subdirectory path
let db_path = storage.data_subdir(DataSubdir::Database).join("app.db");


// Get config file path
let config_path = storage.get_path(StorageType::Config, "settings.json");


// Get cache directory for custom use
let cache_path = storage.cache_dir().join("my_cache_file");


// Check if using fallback location
if storage.using_fallback() {
    println!("Warning: Using fallback storage");
}


// Read user config if it exists
if let Some(content) = storage.read_user_config("config.json").await {
    println!("Found user config: {}", content);
}


// List all user config files
for file in storage.list_user_config_files().await {
    println!("User config file: {:?}", file);
}
```

--------------------------------

### Get Session Messages - GET /api/v1/project/{project_id}/otel/sessions/{session_id}/messages

Source: https://sideseat.ai/docs/reference/api/sessions

Get normalized messages (SideML format) across the session.

```http
GET /api/v1/project/{project_id}/otel/sessions/{session_id}/messages
```

--------------------------------

### GET /api/v1/project/{project_id}/otel/sessions/filter-options

Source: https://sideseat.ai/docs/reference/api/sessions

Get filter options for sessions.

```APIDOC
## GET /api/v1/project/{project_id}/otel/sessions/filter-options

### Description
Get filter options for sessions.

### Method
GET

### Endpoint
/api/v1/project/{project_id}/otel/sessions/filter-options

### Parameters
#### Path Parameters
- **project_id** (string) - Required - The project ID
```

--------------------------------

### Quick Start: Instrument Vertex AI with SideSeat

Source: https://sideseat.ai/docs/integrations/providers/vertex-ai

Initializes SideSeat with the VertexAI framework, then initializes the Vertex AI SDK and generates content with a Gemini model. Requires SideSeat running locally, the `sideseat[vertex-ai]` extra, and Google Cloud credentials.

```python
import vertexai
from vertexai.generative_models import GenerativeModel
from sideseat import SideSeat, Frameworks


SideSeat(framework=Frameworks.VertexAI)


vertexai.init(project="your-project", location="us-central1")
model = GenerativeModel("gemini-2.5-flash")
response = model.generate_content("What is the speed of light?")
print(response.text)
```

--------------------------------

### Install Langflow and SideSeat

Source: https://sideseat.ai/docs/integrations/frameworks/other

Install the required Langflow and SideSeat packages.

```bash
pip install langflow sideseat
```

--------------------------------

### Example Project Config JSON

Source: https://sideseat.ai/docs/reference/config

A complete example of the project config file used in SideSeat. It lists all supported option groups including server, auth, otel, pricing, files, rate_limit, database, update, and debug. Settings are merged with higher-priority sources, so only overridden fields need to be present.

```json
{
  "server": {
    "host": "127.0.0.1",
    "port": 5388
  },
  "auth": {
    "enabled": true
  },
  "otel": {
    "grpc": {
      "enabled": true,
      "port": 4317
    },
    "retention": {
      "max_age_minutes": 10080,
      "max_spans": 5000000
    },
    "auth": {
      "required": false
    }
  },
  "pricing": {
    "sync_hours": 24
  },
  "files": {
    "enabled": true,
    "storage": "filesystem",
    "quota_bytes": 1073741824,
    "filesystem": {
      "path": "/custom/files"
    }
  },
  "rate_limit": {
    "enabled": false,
    "per_ip": false,
    "api_rpm": 1000,
    "ingestion_rpm": 10000,
    "auth_rpm": 100,
    "files_rpm": 1000,
    "bypass_header": "X-SideSeat-Bypass"
  },
  "database": {
    "transactional": "sqlite",
    "analytics": "duckdb",
    "cache": "memory"
  },
  "update": {
    "enabled": true
  },
  "debug": false
}
```

--------------------------------

### Install Smolagents dependencies

Source: https://sideseat.ai/docs/integrations/frameworks/other

Install the required packages for Smolagents integration.

```bash
pip install smolagents "sideseat[smolagents]"
```

--------------------------------

### Best practices exporter setup for production, development, and CI/CD

Source: https://sideseat.ai/docs/sdks/python/exporters

Best practices setup: default OTLP for production, console exporter for development when DEBUG is set, and file exporter for CI/CD when CI is set.

```python
import os
from sideseat import SideSeat


# Production setup
client = SideSeat()


# Development setup
if os.getenv("DEBUG"):
    client.telemetry.setup_console_exporter()


# CI/CD setup
if os.getenv("CI"):
    client.telemetry.setup_file_exporter("traces.jsonl")
```

--------------------------------

### Install Agno dependencies

Source: https://sideseat.ai/docs/integrations/frameworks/other

Install the required packages for Agno integration.

```bash
pip install agno openai "sideseat[agno]"
```

--------------------------------

### Show version and help

Source: https://sideseat.ai/docs/reference/cli

Commands to display the current version of the CLI and access the help menu.

```bash
# Show version
sideseat --version


# Show help
sideseat --help
```

--------------------------------

### Load configuration from file

Source: https://sideseat.ai/docs/reference/cli

Specify a path to a JSON configuration file.

```bash
sideseat --config /path/to/sideseat.json
```

--------------------------------

### Install Haystack and SideSeat

Source: https://sideseat.ai/docs/integrations/frameworks/other

Install the haystack-ai package and the sideseat extra for Haystack.

```bash
pip install haystack-ai "sideseat[haystack]"
```

--------------------------------

### Initialize SDK and Generate Text

Source: https://sideseat.ai/docs/sdks/typescript

Demonstrates initializing the Sideseat SDK with configuration options and using it with the Vercel AI SDK to generate text.

```typescript
import { init, Frameworks } from '@sideseat/sdk';


// Initialize with all options
const client = await init({
  framework: Frameworks.VercelAI,
  endpoint: 'http://localhost:5388',
  projectId: 'my-project',
  apiKey: 'sk-xxx',
  serviceName: 'my-ai-agent',
  debug: true
});


// Your AI application code
import { generateText } from 'ai';
import { bedrock } from '@ai-sdk/amazon-bedrock';


const { text } = await generateText({
  model: bedrock('us.anthropic.claude-sonnet-4-5-20250929-v1:0'),
  prompt: 'Hello!',
  experimental_telemetry: { isEnabled: true },
});
console.log(text);
```

--------------------------------

### GET /api/v1/project/{project_id}/otel/traces/{trace_id}

Source: https://sideseat.ai/docs/reference/api/traces

Get a single trace with nested spans.

```APIDOC
## GET /api/v1/project/{project_id}/otel/traces/{trace_id}

### Description
Get a single trace with nested spans.

### Method
GET

### Endpoint
/api/v1/project/{project_id}/otel/traces/{trace_id}

### Parameters
#### Path Parameters
- **project_id** (string) - Required - The project identifier.
- **trace_id** (string) - Required - The trace identifier.

#### Query Parameters
- **include_raw_span** (boolean) - Optional - Include the raw OTLP span JSON
```

--------------------------------

### Basic development server commands

Source: https://sideseat.ai/docs/reference/cli

Commands to start the development server with various flags for debugging and authentication.

```bash
# Basic development server
sideseat


# With debug output
sideseat --debug


# Disable authentication
sideseat --no-auth
```

--------------------------------

### Install OpenAI dependencies

Source: https://sideseat.ai/docs

Install the required packages for OpenAI using pip or uv.

```bash
pip install "sideseat[openai]" openai
```

```bash
uv add "sideseat[openai]" openai
```

--------------------------------

### Import sideseat and initialize global instance

Source: https://sideseat.ai/docs/sdks/python/runtime

Shows module-level shorthand functions on the global instance created by sideseat.init(). Registers an agent and connects.

```python
import sideseat


sideseat.init(framework="strands")
sideseat.register(my_agent)
sideseat.connect()
```

--------------------------------

### Install Anthropic dependencies

Source: https://sideseat.ai/docs

Install the required packages for Anthropic using pip or uv.

```bash
pip install "sideseat[anthropic]" anthropic
```

```bash
uv add "sideseat[anthropic]" anthropic
```

--------------------------------

### Use OpenAI with Python

Source: https://sideseat.ai/docs

Initialize SideSeat with OpenAI and use the client to create chat completions.

```python
from sideseat import SideSeat, Frameworks
from openai import OpenAI


SideSeat(framework=Frameworks.OpenAI)


client = OpenAI()
response = client.chat.completions.create(
  model="gpt-5-mini",
  messages=[{"role": "user", "content": "What is 2+2?"}],
)
print(response.choices[0].message.content)
```

--------------------------------

### Install Manual OpenTelemetry Dependencies

Source: https://sideseat.ai/docs/integrations/frameworks/strands-typescript

Install the necessary OpenTelemetry packages for manual instrumentation.

```bash
npm install @strands-agents/sdk @opentelemetry/sdk-trace-node @opentelemetry/sdk-trace-base @opentelemetry/exporter-trace-otlp-http
```

--------------------------------

### Initialize SideSeat for browser-use and run an agent

Source: https://sideseat.ai/docs/integrations/frameworks/other

Initialize SideSeat with the BrowserUse framework, then run a browser-use agent. No extra setup is needed because browser-use exports OpenTelemetry through the global provider, and SideSeat detects it via the gen_ai.provider.name attribute.

```python
import asyncio


from sideseat import SideSeat, Frameworks
from browser_use import Agent, ChatOpenAI


SideSeat(framework=Frameworks.BrowserUse)




async def main():
    agent = Agent(task="Find the docs", llm=ChatOpenAI(model="gpt-5-mini"))
    print(await agent.run())




asyncio.run(main())
```

--------------------------------

### Install TypeScript dependencies

Source: https://sideseat.ai/docs/integrations/frameworks/claude-agent-sdk

Install the required npm packages for the Claude Agent SDK.

```bash
npm install @anthropic-ai/claude-agent-sdk @sideseat/sdk
```

--------------------------------

### Integrate Google ADK (Python)

Source: https://sideseat.ai/docs

Install and initialize SideSeat with Google ADK.

```bash
pip install sideseat google-adk
```

```bash
uv add sideseat google-adk
```

```python
import asyncio
from sideseat import SideSeat, Frameworks
from google.adk.agents import Agent
from google.adk.runners import Runner
from google.adk.sessions import InMemorySessionService
from google.genai import types


SideSeat(framework=Frameworks.GoogleADK)


agent = Agent(model="gemini-2.5-flash", name="assistant", instruction="You are helpful.")


async def main():
  session_service = InMemorySessionService()
  runner = Runner(agent=agent, app_name="app", session_service=session_service)
  session = await session_service.create_session(app_name="app", user_id="user")
  message = types.Content(role="user", parts=[types.Part(text="What is 2+2?")])
  async for event in runner.run_async(session_id=session.id, user_id="user", new_message=message):
      if event.content and event.content.parts:
          for part in event.content.parts:
              if hasattr(part, "text") and part.text:
                  print(part.text)


asyncio.run(main())
```

--------------------------------

### Install Python dependencies

Source: https://sideseat.ai/docs/integrations/frameworks/claude-agent-sdk

Install the required Python packages for the Claude Agent SDK.

```bash
pip install claude-agent-sdk sideseat
```

--------------------------------

### Integrate Strands (Python)

Source: https://sideseat.ai/docs

Install and initialize SideSeat with the Strands framework.

```bash
pip install sideseat strands-agents
```

```bash
uv add sideseat strands-agents
```

```python
from sideseat import SideSeat, Frameworks
from strands import Agent


SideSeat(framework=Frameworks.Strands)


agent = Agent()
print(agent("What is 2+2?"))
```

--------------------------------

### Install dependencies for manual instrumentation

Source: https://sideseat.ai/docs/integrations/frameworks/openai-agents

Install the necessary packages for manual logfire instrumentation.

```bash
pip install openai-agents "logfire>=4.29.0" opentelemetry-exporter-otlp
```

```bash
uv add openai-agents "logfire>=4.29.0" opentelemetry-exporter-otlp
```

--------------------------------

### Use Google GenAI with Python

Source: https://sideseat.ai/docs

Initialize SideSeat with Google GenAI and use the client to generate content.

```python
from sideseat import SideSeat, Frameworks
from google import genai


SideSeat(framework=Frameworks.GoogleGenAI)


client = genai.Client(api_key="YOUR_API_KEY")
response = client.models.generate_content(model="gemini-2.5-flash", contents="What is 2+2?")
print(response.text)
```

--------------------------------

### Use Bedrock with Python

Source: https://sideseat.ai/docs

Initialize SideSeat with Bedrock and use the boto3 client to converse with the model.

```python
from sideseat import SideSeat, Frameworks
import boto3


SideSeat(framework=Frameworks.Bedrock)


client = boto3.client("bedrock-runtime", region_name="us-east-1")
response = client.converse(
  modelId="us.anthropic.claude-sonnet-4-5-20250929-v1:0",
  messages=[{"role": "user", "content": [{"text": "What is 2+2?"}]}],
)
print(response["output"]["message"]["content"][0]["text"])
```

--------------------------------

### Configure Backend via CLI or Environment Variable

Source: https://sideseat.ai/docs/reference/secrets

Examples of setting the secrets backend using command-line arguments or environment variables.

```bash
sideseat --secrets-backend vault
# or
SIDESEAT_SECRETS_BACKEND=env sideseat
```

--------------------------------

### GET /api/v1/project/{project_id}/otel/traces/filter-options

Source: https://sideseat.ai/docs/reference/api/traces

Get available filter values for building UI dropdowns.

```APIDOC
## GET /api/v1/project/{project_id}/otel/traces/filter-options

### Description
Get available filter values for building UI dropdowns.

### Method
GET

### Endpoint
/api/v1/project/{project_id}/otel/traces/filter-options

### Parameters
#### Path Parameters
- **project_id** (string) - Required - The project identifier.
```
Tokens:
Raw