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

# Quickstart

> Get started with the Vals Platform

Get up and running with the Vals Platform in minutes. This guide walks you through creating an account, setting up a test suite, and running your first evaluation.

## 1. Create an Account

Sign up at [platform.vals.ai](https://platform.vals.ai) and confirm your email.

## 2. Create a Test Suite

Once logged in, navigate to the [Suites page](https://platform.vals.ai/project/default-project/suites) and click **+ New Suite**.

**Quick start**: Click the dropdown on the right of the button and select **New Suite from Library** to import a pre-built suite (e.g. Basic Examples, LegalBench, CUAD).

To create a suite from scratch:

1. Give your suite a title and description.
2. Click **Add Test** to create your first test.
3. Enter a **Test Input** — the prompt you want to send to the model.
4. Add one or more **Checks** — each check verifies a specific aspect of the model's output (e.g. `includes`, `is_concise`, `grammar`).

For a full walkthrough, see [Creating a Test Suite](/web_app/creating_test_suites).

## 3. Run Your Suite

Click the **Start Run** button in the upper-right corner of the test suite page. Choose a model (e.g. GPT-4o), configure any parameters, and press **Run**.

Once the run completes, you can view results including pass rates, confidence scores, and per-check feedback on the [Results](/web_app/results) page.

## 4. (Optional) Use the SDK

You can also create and run test suites programmatically with the Python SDK.

### Install

```bash theme={null}
pip install valsai
```

### Authenticate

Create an API key from the Admin page of the [platform](https://platform.vals.ai), then set it in your environment:

```bash theme={null}
export VALS_API_KEY=<YOUR_API_KEY>
```

### Create and Run a Suite

```python theme={null}
from vals import Suite, Test, Check

async def main():
    suite = Suite(
        title="My First Suite",
        tests=[
            Test(
                input_under_test="What is QSBS?",
                checks=[
                    Check(operator="includes", criteria="C Corporation"),
                    Check(operator="grammar"),
                ]
            )
        ],
    )
    await suite.create()

    run = await suite.run(model="openai/gpt-4o-mini", wait_for_completion=True)
    print(f"Run URL: {run.url}")
    print(f"Pass rate: {run.pass_rate}")
```

For more details, see the full [SDK documentation](/sdk/setup).

## Next Steps

* [Operators](/web_app/operators) — Browse the full list of available check operators
* [Writing Effective Criteria](/web_app/effective_tests) — Tips for getting the best results from your checks
* [Providing Context](/web_app/contexts) — Add files and metadata to your tests
* [CI/CD Integration](/cli/cicd) — Run Vals automatically on every PR with GitHub Actions