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

# Speech to Text

> Learn how to evaluate and compare STT providers with your data

[Calibrate](https://calibrate.artpark.ai) lets you evaluate multiple STT providers simultaneously using your own dataset. This guide will walk you through creating an evaluation, managing reusable datasets, and sharing your results.

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/PaMLSN3Du6I" title="Speech-to-Text Evaluation Walkthrough" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

## Start a new evaluation

From the sidebar, click on **Speech-to-Text** to view all your evaluations and datasets. Click the **New evaluation** button to create a new evaluation.

<Frame>
  <img src="https://mintcdn.com/amandalmia/TsDdvjhyewlsTagk/quickstart/images/stt_overview.png?fit=max&auto=format&n=TsDdvjhyewlsTagk&q=85&s=ae7ec78f171804cfcf91f1c40a33b683" alt="Speech-to-Text Evaluations List" width="3024" height="948" data-path="quickstart/images/stt_overview.png" />
</Frame>

## Add your dataset

On the **Dataset** tab, choose how to provide your audio samples:

<Frame>
  <img src="https://mintcdn.com/amandalmia/TsDdvjhyewlsTagk/quickstart/images/stt_new_dataset.png?fit=max&auto=format&n=TsDdvjhyewlsTagk&q=85&s=03479753725d57fae0de762fffcc3314" alt="New STT Evaluation - Dataset Tab" width="2492" height="1038" data-path="quickstart/images/stt_new_dataset.png" />
</Frame>

<AccordionGroup>
  <Accordion title="Upload new" icon="upload" defaultOpen>
    Create a new dataset inline. Give it a name, then add samples in one of two ways:

    1. **Add samples inline** — Click **Upload .wav** to attach an audio file and type the reference transcription for each row. Click **+ Add another sample** to add more.

    2. **Bulk upload via ZIP** — Upload a ZIP file with the following structure:

    ```
    your_dataset.zip
    |-- audios/
    |   |-- sample_1.wav
    |   |-- sample_2.wav
    |   |-- sample_3.wav
    |-- data.csv
    ```

    The `data.csv` should have two columns:

    | audio\_file   | text                                              |
    | ------------- | ------------------------------------------------- |
    | sample\_1.wav | This is the reference transcription for sample 1. |
    | sample\_2.wav | This is the reference transcription for sample 2. |
    | sample\_3.wav | This is the reference transcription for sample 3. |

    <Tip>
      Click **Download sample ZIP** to get a template with the correct structure.
    </Tip>

    <Frame>
      <img src="https://mintcdn.com/amandalmia/TsDdvjhyewlsTagk/quickstart/images/stt-dataset-upload.png?fit=max&auto=format&n=TsDdvjhyewlsTagk&q=85&s=9a309aecf2de46faca7520c742943571" alt="STT Dataset Upload" width="2486" height="1086" data-path="quickstart/images/stt-dataset-upload.png" />
    </Frame>

    Your dataset is automatically saved so you can reuse it in future evaluations.
  </Accordion>

  <Accordion title="Use existing dataset" icon="database">
    If you've already created a dataset, switch to **Use existing dataset** to pick from your saved datasets.

    <Frame>
      <img src="https://mintcdn.com/amandalmia/TsDdvjhyewlsTagk/quickstart/images/stt-existing-dataset.png?fit=max&auto=format&n=TsDdvjhyewlsTagk&q=85&s=68ad8b8836fd3d553bc3bc2940f2c330" alt="Use Existing Dataset" width="2500" height="606" data-path="quickstart/images/stt-existing-dataset.png" />
    </Frame>
  </Accordion>
</AccordionGroup>

<Tip>
  You can also create and manage datasets independently from the **Datasets**
  tab. See [Datasets](/docs/core-concepts/speech-to-text#datasets) to learn how to
  create reusable datasets and run evaluations directly from them.
</Tip>

## Configure settings

Switch to the **Settings** tab to select the language and the providers you want to compare:

<Frame>
  <img src="https://mintcdn.com/amandalmia/TsDdvjhyewlsTagk/quickstart/images/stt-setting.png?fit=max&auto=format&n=TsDdvjhyewlsTagk&q=85&s=5714668c7b5a825fb1aebe11a09eb47e" alt="STT Settings - Language and Providers" width="2506" height="1124" data-path="quickstart/images/stt-setting.png" />
</Frame>

Select a **Language** from the dropdown and check the providers you want to evaluate. Each provider shows the model it uses.

## Run evaluation

Click the **Evaluate** button at the top to start the evaluation. You will be redirected to the results page where you can monitor progress in real-time.

## View results

### Outputs

The **Outputs** tab shows per-provider results. Select a provider from the list on the left to see its overall metrics and per-sample results.

<Frame>
  <img src="https://mintcdn.com/amandalmia/TsDdvjhyewlsTagk/quickstart/images/stt_output.png?fit=max&auto=format&n=TsDdvjhyewlsTagk&q=85&s=3eec7c4d110a1c8502b4e92e58defc98" alt="STT Outputs with Audio Playback" width="2892" height="976" data-path="quickstart/images/stt_output.png" />
</Frame>

Each sample row includes:

* **Audio** — An inline audio player to listen to the original recording
* **Ground Truth** — The reference transcription you provided
* **Prediction** — What the STT provider transcribed
* **WER** — Word Error Rate for that sample
* **Similarity** — String similarity score
* **LLM Judge** — Pass/Fail based on semantic evaluation

### Leaderboard

The **Leaderboard** tab shows a side-by-side comparison across all providers with aggregated metrics and bar charts.

<Frame>
  <img src="https://mintcdn.com/amandalmia/sCrD-Z6UBCaUqF03/quickstart/images/stt_leaderboard.png?fit=max&auto=format&n=sCrD-Z6UBCaUqF03&q=85&s=c1535741550d21d77c6e5182a1671f08" alt="STT Leaderboard" width="1748" height="1110" data-path="quickstart/images/stt_leaderboard.png" />
</Frame>

## Sharing results publicly

Once your evaluation completes, you can make the results publicly accessible by clicking the **Share** button on the results page.

<Frame>
  <img src="https://mintcdn.com/amandalmia/TsDdvjhyewlsTagk/quickstart/images/stt_share.png?fit=max&auto=format&n=TsDdvjhyewlsTagk&q=85&s=d453e02a3b745c61edc25986e82becbc" alt="Share button on evaluation results" width="1154" height="618" data-path="quickstart/images/stt_share.png" />
</Frame>

This toggles the evaluation to **Public** and generates a shareable link. Anyone with the link can view the leaderboard and outputs without needing a Calibrate account.

<Frame>
  <img src="https://mintcdn.com/amandalmia/TsDdvjhyewlsTagk/quickstart/images/stt_public.png?fit=max&auto=format&n=TsDdvjhyewlsTagk&q=85&s=3f942d63ac36348220e04774ac1834fc" alt="Public evaluation with copy link" width="3024" height="1646" data-path="quickstart/images/stt_public.png" />
</Frame>

Click the **Public** button again to make the evaluation private.

## Next steps

<CardGroup cols={2}>
  <Card title="Core Concepts" icon="chart-bar" href="/docs/core-concepts/speech-to-text">
    Learn about STT metrics — WER, String Similarity, and LLM Judge
  </Card>

  <Card title="Datasets" icon="database" href="/docs/core-concepts/speech-to-text#datasets">
    Save and reuse evaluation data across multiple evaluations
  </Card>

  <Card title="LLM tests" icon="brain" href="/docs/quickstart/text-to-text">
    Find the best LLM for your agent
  </Card>
</CardGroup>
