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

# Quick Start

> Create your first pipeline in 5 minutes

This guide walks you through creating a model deployment pipeline: add a model from HuggingFace, then deploy it to a cluster.

## Step 1: Navigate to Pipelines

1. Log in to [Bud AI Foundry](https://admin.dev.bud.studio)
2. Click **Pipelines** in the left sidebar
3. Click the **+ Pipeline** button

<img src="https://mintcdn.com/budecosystem-b7b14df4/8SBnb7toeDyHha2F/images/pipelines/pipeline-list.png?fit=max&auto=format&n=8SBnb7toeDyHha2F&q=85&s=29c8a2045c239c739930ee641a99049d" alt="Pipeline List" width="1440" height="900" data-path="images/pipelines/pipeline-list.png" />

## Step 2: Name Your Pipeline

1. Enter a name: "Model Deployment Pipeline"
2. Add a description: "Add and deploy a model from HuggingFace"
3. Click **Create**

## Step 3: Add Actions

The pipeline editor opens with a visual canvas. Let's build the workflow:

### Add Model Action

1. From the **Actions** panel on the right, expand **Model Operations**
2. Drag **Add Model** onto the canvas
3. Click the action to configure it:
   * **Model URI**: `meta-llama/Llama-3.2-1B-Instruct`
   * **Model Name**: `Llama-3.2-1B-Instruct`
   * **Model Source**: `hugging_face`
4. Click **Save**

<img src="https://mintcdn.com/budecosystem-b7b14df4/8SBnb7toeDyHha2F/images/pipelines/pipeline-editor-flow.png?fit=max&auto=format&n=8SBnb7toeDyHha2F&q=85&s=e7534dda569eb2a9f1ad818390e0794c" alt="Pipeline Editor" width="1440" height="900" data-path="images/pipelines/pipeline-editor-flow.png" />

### Deploy Model Action

1. From the **Actions** panel, expand **Deployment**
2. Drag **Deploy Model** onto the canvas
3. Connect the actions: click the dot on Add Model and drag to Deploy Model
4. Configure the deployment:
   * **Model ID**: `steps.add_model.output.model_id`
   * **Cluster ID**: Select your cluster from dropdown
   * **Deployment Name**: `llama-deployment`
5. Click **Save**

### Add Set Output

1. Drag **Set Output** action after Deploy Model
2. Connect Deploy Model → Set Output
3. Configure:
   * **Key**: "endpoint\_url"
   * **Value**: `steps.deploy_model.output.endpoint_url`
4. Click **Save**

## Step 4: Execute the Pipeline

1. Click the **Execute** button in the top-right
2. Click **Run**

## Step 5: Monitor Execution

1. Click the **Runs** tab
2. You'll see your execution progress through each step
3. Click **View** to see detailed logs and outputs

<img src="https://mintcdn.com/budecosystem-b7b14df4/8SBnb7toeDyHha2F/images/pipelines/runs-table.png?fit=max&auto=format&n=8SBnb7toeDyHha2F&q=85&s=94cb9f85a6ee3e99d8e0ff00c55219fb" alt="Pipeline Runs" width="1440" height="900" data-path="images/pipelines/runs-table.png" />

Once complete, you'll have a deployed model endpoint ready to serve inference requests! 🎉

## Using the SDK

You can also create and execute pipelines programmatically:

```python theme={null}
from bud import BudClient

client = BudClient()

# Execute the Add Model → Deploy Model pipeline
execution = client.executions.run_ephemeral(
    pipeline_definition={
        "name": "Model Deployment Pipeline",
        "steps": [
            {
                "id": "add_model",
                "name": "Add Model",
                "action": "model_add",
                "params": {
                    "model_uri": "meta-llama/Llama-3.2-1B-Instruct",
                    "model_name": "Llama-3.2-1B-Instruct",
                    "model_source": "hugging_face"
                },
                "depends_on": []
            },
            {
                "id": "deploy_model",
                "name": "Deploy Model",
                "action": "deployment_create",
                "params": {
                    "model_id": "{{steps.add_model.output.model_id}}",
                    "cluster_id": "cluster_abc123",
                    "deployment_name": "llama-deployment"
                },
                "depends_on": ["add_model"]
            }
        ],
        "outputs": {
            "endpoint_url": "{{steps.deploy_model.output.endpoint_url}}"
        },
        "description": "Add and deploy a model from HuggingFace"
    },
    wait=True
)

print(f"Status: {execution.status}")
print(f"Endpoint: {execution.outputs.get('endpoint_url')}")
```

<Tip>
  For advanced SDK usage, see the [API Reference](/developer-docs/api-reference) (coming soon).
</Tip>

## Next Steps

<CardGroup cols={2}>
  <Card title="Pipeline Concepts" icon="book" href="/pipelines/pipeline-concepts">
    Learn about DAGs and action types
  </Card>

  <Card title="Detailed Tutorial" icon="graduation-cap" href="/pipelines/creating-first-pipeline">
    Build more complex workflows
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/pipelines/troubleshooting">
    Common issues and solutions
  </Card>
</CardGroup>
