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

# Quickstart

> Sign up, configure your first integration, run a training, and register the resulting metric — end-to-end in about 15 minutes.

This walkthrough takes you from a fresh sign-up to a registered custom metric. By the end, you'll have one project, one training run, and one metric available in the Galileo metrics store.

## Before you start

<Note>
  **Enterprise tier and your own deployment.** Luna Studio is part of the enterprise tier of Galileo and is deployed by Galileo into your own cluster or cloud. See [Availability and deployment](/luna-studio/ui/availability), or [contact
  us](https://galileo.ai/contact-sales) to get started.
</Note>

You'll need:

* An instance of Luna Studio deployed for your org (Luna Studio is part of the enterprise tier — see [Availability and deployment](/luna-studio/ui/availability)).
* An email address for the Luna Studio account.
* An API key for at least one LLM provider — typically [OpenAI](https://platform.openai.com/api-keys), [Anthropic](https://console.anthropic.com/settings/keys), or [Google AI Studio](https://aistudio.google.com/api-keys).
* A small labelled dataset (CSV or JSONL with the columns your metric requires). Use at least 300 rows for a first run when possible.
* *Optional but recommended:* a [Galileo](/what-is-galileo) API key, so you can import datasets and register metrics into the Galileo platform.

<Tip>
  Don't have a labelled training dataset yet? Luna Studio can **generate a training set** from your test set — see the [training-set step below](#step-6-add-a-training-set). The test set still needs enough labelled rows for reliable
  evaluation.
</Tip>

## Walkthrough

<Steps>
  <Step title="Sign up">
    Open your org's Luna Studio URL and create an account.

    {" "}

    <Frame caption="Create a Luna Studio account">
      <img src="https://mintcdn.com/v2galileo/-aQkdd7oOglUYIo1/images/luna-studio/auth/sign-up.png?fit=max&auto=format&n=-aQkdd7oOglUYIo1&q=85&s=9ef3d50162a1f505e3054fedb881c4bf" alt="Sign up screen" width="1024" height="659" data-path="images/luna-studio/auth/sign-up.png" />
    </Frame>

    Enter an email and a password (8+ characters), accept the terms, and click **Create account**.
  </Step>

  <Step title="Connect your first LLM provider">
    On first launch, Luna Studio drops you into the onboarding wizard. Pick a supported LLM provider, such as OpenAI or Anthropic, and click **Add integration** on the card.

    {" "}

    <Frame caption="Onboarding, step 1 — connect at least one LLM provider">
      <img src="https://mintcdn.com/v2galileo/-aQkdd7oOglUYIo1/images/luna-studio/onboarding/step-1-providers.png?fit=max&auto=format&n=-aQkdd7oOglUYIo1&q=85&s=e678c32e68aed8d3fd534bcc0043adfc" alt="Onboarding step 1" width="1024" height="659" data-path="images/luna-studio/onboarding/step-1-providers.png" />
    </Frame>

    A modal opens with the fields the provider needs (typically an API key). Paste it and click **Save changes**.

    Optionally add the **Galileo** integration in the section below — this unlocks the "Import from Galileo" dataset source later.
  </Step>

  <Step title="Create your first project">
    Click **Continue** and enter a project name (e.g. `support-tone-classifier`). Click **Continue** again — Luna Studio creates the project and routes you to its **Training runs** page.

    {" "}

    <Frame caption="Onboarding, step 2 — name your first project">
      <img src="https://mintcdn.com/v2galileo/-aQkdd7oOglUYIo1/images/luna-studio/onboarding/step-2-create-project.png?fit=max&auto=format&n=-aQkdd7oOglUYIo1&q=85&s=4a1370e90be43633f9abe41c084ec935" alt="Onboarding step 2" width="1024" height="659" data-path="images/luna-studio/onboarding/step-2-create-project.png" />
    </Frame>
  </Step>

  <Step title="Start a new training run">On the project page, click **New run** in the top right. The run creation flow opens at **Step 1 — Metric**.</Step>

  <Step title="Pick a metric (Step 1)">
    Pick a metric from the dropdown. The list includes Galileo presets, custom Galileo metrics, and saved custom prompts that are trainable in Luna Studio.

    {" "}

    <Frame caption="New run, Step 1 — pick the metric you want to fine-tune">
      <img src="https://mintcdn.com/v2galileo/-aQkdd7oOglUYIo1/images/luna-studio/runs/new-run-metric.png?fit=max&auto=format&n=-aQkdd7oOglUYIo1&q=85&s=72c3c73ca673fc1f2366d7ad429c7d02" alt="Metric step" width="1024" height="659" data-path="images/luna-studio/runs/new-run-metric.png" />
    </Frame>

    Or click the dropdown's **Use custom prompt** option to write your own LLM-as-judge prompt. See [Step 1: Metric](/luna-studio/ui/runs/new-run/step-1-metric) for the full reference.

    Click **Next step**.
  </Step>

  <Step title="Add a test set (Step 2)">
    Pick an existing test set from the dropdown, or click **Add new test set** to upload one.

    {" "}

    <Frame caption="New run, Step 2 — pick or upload a test set to evaluate against">
      <img src="https://mintcdn.com/v2galileo/-aQkdd7oOglUYIo1/images/luna-studio/runs/new-run-test-set.png?fit=max&auto=format&n=-aQkdd7oOglUYIo1&q=85&s=cc1f7b4b85f4c158b1691bef7d1f60f1" alt="Test set step" width="1024" height="659" data-path="images/luna-studio/runs/new-run-test-set.png" />
    </Frame>

    Test sets need the columns required by your metric, plus a `label` column. Luna Studio validates the file as soon as you upload it — wait for the **Validated** status before continuing.

    Click **Next step**.
  </Step>

  <Step title="Add a training set (Step 3)" id="step-6-add-a-training-set">
    Choose a training source:

    * **Generate from test set** (recommended for a first run) — Luna Studio uses 20% of your test set as seed examples and generates 2,000 labelled training examples using your LLM-as-judge prompt from Step 1.
    * **Add training logs** — upload or import your own production logs.
    * **Use existing training set** — reuse a training dataset that already exists in your workspace.

          <Frame caption="New run, Step 3 — generate, add, or reuse a training set">
            <img src="https://mintcdn.com/v2galileo/-aQkdd7oOglUYIo1/images/luna-studio/runs/new-run-training-set.png?fit=max&auto=format&n=-aQkdd7oOglUYIo1&q=85&s=1f490da9826438954dda14c2d7911c5b" alt="Training set step" width="1024" height="659" data-path="images/luna-studio/runs/new-run-training-set.png" />
          </Frame>

      If you pick Generate, a drawer opens. Pick a model from your configured providers and click **Generate sample dataset**. Review the sample rows, select any that should steer regeneration, and click **Generate final dataset**.

      Click **Next step**.
  </Step>

  <Step title="Confirm and launch (Step 4)">
    Review the run summary. The base model is selected from the models configured for your organization.

    {" "}

    <Frame caption="New run, Step 4 — pick a base model and launch fine-tuning">
      <img src="https://mintcdn.com/v2galileo/-aQkdd7oOglUYIo1/images/luna-studio/runs/new-run-config-launch.png?fit=max&auto=format&n=-aQkdd7oOglUYIo1&q=85&s=20f8533a8a5ca4c670b83a751c121974" alt="Config and launch step" width="1024" height="659" data-path="images/luna-studio/runs/new-run-config-launch.png" />
    </Frame>

    Click **Confirm and launch**. The run enters the **Queued** state and you're routed back to the project page.
  </Step>

  <Step title="Wait for training to complete">
    Training runs progress through **Queued → Training → Fine-tuned**. Click the run row to open its details page and see live status.

    Once the run reaches **Fine-tuned**, the run details page shows a metrics grid (F1 score, AUC-ROC, etc.) versus a baseline.

    {" "}

    <Frame caption="Run details for a fine-tuned run, ready to register">
      <img src="https://mintcdn.com/v2galileo/-aQkdd7oOglUYIo1/images/luna-studio/runs/run-details.png?fit=max&auto=format&n=-aQkdd7oOglUYIo1&q=85&s=a1b954dccb618f5a47e5eadcc5a3dcaf" alt="Run details" width="1024" height="659" data-path="images/luna-studio/runs/run-details.png" />
    </Frame>
  </Step>

  <Step title="Register your metric">
    Happy with the result? Click **Register metric** in the run details footer. Enter a metric name and click **Register**.

    Your metric now appears in the [Galileo metrics store](/concepts/metrics/overview) and can be used across Galileo for evaluation, observability, and guardrails. The run's status flips to **Registered**.
  </Step>
</Steps>

Congratulations! You've now created your first custom Luna metric.

## What's next

<CardGroup cols={2}>
  <Card title="Core concepts" icon="book-open" href="/luna-studio/ui/core-concepts">
    Understand the relationships between projects, runs, metrics, and datasets.
  </Card>

  <Card title="Luna Studio deep dive" icon="wand-magic-sparkles" href="/luna-studio/ui/runs/new-run/overview">
    Deep dive on every step of the new run flow.
  </Card>

  <Card title="Datasets" icon="database" href="/luna-studio/ui/datasets/overview">
    Manage your test sets and training sets.
  </Card>

  <Card title="Integrations" icon="plug" href="/luna-studio/ui/integrations/overview">
    Add provider credentials for the models and platform features your team uses.
  </Card>
</CardGroup>
