> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getbasalt.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Welcome on the Basalt documentation, the place to learn how to use the Basalt API and SDK

export const Button = ({value, variant, icon, href}) => {
  const variants = {
    primary: 'bg-[#000000] dark:text-primary-light text-white border border-transparent dark:border-primary-light shadow-sm [&>svg]:bg-primary-light',
    brand: 'bg-primary dark:bg-primary-light text-white dark:text-gray-700 shadow-sm',
    outline: 'text-gray-700 shadow-sm border dark:text-primary-light bg-white dark:bg-background-dark border border-gray-950/10 dark:border-white/10 hover:border-primary dark:hover:border-primary-light',
    ghost: 'text-gray-700 dark:text-white',
    link: 'text-primary dark:text-primary-light border-none pl-0'
  };
  const classVariant = variants[variant] ?? variants.primary;
  const className = `relative px-3 py-1.5 gap-2 inline-flex items-center justify-center whitespace-nowrap rounded-lg text-sm font-medium ring-offset-background transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 ${classVariant}`;
  return <a href={href} className={className}>
			{value}
			{icon && <Icon icon={icon} iconType="solid" />}
		</a>;
};

## Getting started

Basalt helps you manage prompts, datasets, experiments, and observability for AI features — with an API and SDKs.

<Button variant="primary" value="Create an account" href="https://app.getbasalt.ai" />

<Info>
  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.
</Info>

## The 4 pillars

<CardGroup cols={2}>
  <Card title="Prompts" icon="comment-dots" href="/v1/prompts/introduction">
    Host and version prompts centrally, fetch them at runtime, and roll out changes safely.
  </Card>

  <Card title="Datasets" icon="database" href="/v1/datasets/introduction">
    Store and retrieve structured examples for evaluation, regression, and experimentation.
  </Card>

  <Card title="Observability" icon="chart-line" href="/v1/observabilite/introduction">
    Trace end-to-end AI workflows with `start_observe` and `observe` (OpenTelemetry-based).
  </Card>

  <Card title="Experiments" icon="flask" href="/v1/experiments/introduction">
    Run and compare variants, attach evaluations, and iterate with confidence.
  </Card>
</CardGroup>

## Choose your path

<CardGroup cols={2}>
  <Card title="Quickstart (Python v1)" icon="rocket" href="/v1/quickstart">
    Fetch your first prompt and send your first trace to Basalt.
  </Card>

  <Card title="Install the SDK (Python v1)" icon="terminal" href="/v1/installation">
    Install, authenticate, and initialize the SDK.
  </Card>

  <Card title="Quickstart (TypeScript v0 archive)" icon="rocket" href="/v0/quickstart">
    Use the legacy SDK docs while TypeScript v1 is in progress.
  </Card>

  <Card title="API Reference" icon="terminal" href="/v1/api-reference/introduction">
    Raw HTTP API endpoints (v1).
  </Card>
</CardGroup>