Skip to main content

Getting started

Basalt helps you manage prompts, datasets, experiments, and observability for AI features — with an API and SDKs. Create an account
Basalt Python SDK is documented in v1. If you’re using TypeScript/JavaScript, the v1 SDK is not available yet — use the v0 (archive) docs.

The 4 pillars

Prompts

Host and version prompts centrally, fetch them at runtime, and roll out changes safely.

Datasets

Store and retrieve structured examples for evaluation, regression, and experimentation.

Observability

Trace end-to-end AI workflows with start_observe and observe (OpenTelemetry-based).

Experiments

Run and compare variants, attach evaluations, and iterate with confidence.

Choose your path

Quickstart (Python v1)

Fetch your first prompt and send your first trace to Basalt.

Install the SDK (Python v1)

Install, authenticate, and initialize the SDK.

Quickstart (TypeScript v0 archive)

Use the legacy SDK docs while TypeScript v1 is in progress.

API Reference

Raw HTTP API endpoints (v1).