Tutorials

Step-by-step tutorials for common BenchBox tasks. Each tutorial takes 5-15 minutes.

Getting Started

Tutorial	Time	Description
Your First Benchmark	5 min	Run TPC-H on DuckDB with zero configuration
Understanding Results	10 min	Interpret benchmark output and metrics
Comparing Platforms	10 min	Run the same benchmark on multiple databases
DataFrame Benchmarking	10 min	Use Polars/Pandas instead of SQL

Prerequisites

• BenchBox installed (pip install benchbox or uv add benchbox)
• Python 3.11+
• No database servers required (DuckDB is embedded)

Related Resources

• CLI Quick Reference - Command reference
• Examples Directory - Runnable Python scripts
• Platform Guides - Platform-specific setup

• Your First Benchmark
• Understanding Benchmark Results
• Comparing Platforms
• DataFrame Benchmarking Quickstart