SideSeat

Quick Start

Get up and running with SideSeat in minutes:

# Clone the repository
git clone https://github.com/spugachev/sideseat.git
cd sideseat

# Install dependencies and build
make setup

# Start development server
make dev

Click the URL shown in the terminal (e.g., http://localhost:5001/ui?token=...) to access the dashboard.

Features

OpenTelemetry Collector

Built-in OTLP-compatible trace collector with automatic AI framework detection and GenAI field extraction.

Real-time Streaming

SSE-based live trace updates for monitoring agent execution as it happens.

Framework Detection

Automatic detection of LangChain, LlamaIndex, Strands, and other AI frameworks with normalized field extraction.

Efficient Storage

SQLite-based storage with FIFO retention, bounded memory buffers, and disk safety monitoring.

Tech Stack

• Backend: Rust with Axum framework
• Frontend: React 19 with Vite
• Telemetry: OpenTelemetry (OTLP) with SQLite storage
• Database: SQLite with migrations
• CLI: Distributed as NPM package
• Docs: Astro Starlight

Requirements

• Rust 1.75 or higher
• Node.js 20.19+ or 22.12+
• Make

Next Steps

Getting Started

Set up SideSeat and collect your first traces.

OpenTelemetry Collector

Configure trace collection for your AI agents.

REST API Reference

Query traces, spans, and sessions programmatically.

Configuration

Configure server, storage, and retention settings.

Reference Documentation

Authentication

Secure your instance with token-based authentication.

Storage Manager

Platform paths for data, config, cache, and logs.

Secret Manager

Credential storage using OS-native secure backends.