Prerequisites
Before you begin, you’ll need:- An existing dbt project with well-structured data models
- A Buster account (get started at buster.so)
If you use SQLMesh, AtScale, or Cube, please contact us for personalized assistance. If you don’t use any data modeling tool, you’ll need to follow our manual onboarding process.
Step 1: Install the CLI
Don’t use Brew? Check out the installation guide for other options.
Step 2: Authenticate with Buster
Before you can use Buster, you’ll need to authenticate with your Buster account:If you are using Buster locally, you can use the
--local
flag to authenticate with your local Buster instance.Step 3: Initialize Your Project & Connect Data Source
Let’s initialize your Buster project and connect to your data source in one step using thebuster init
command:
- Asks you to select your data warehouse type (Postgres, BigQuery, Snowflake, etc.)
- Prompts for connection details like host, port, credentials, etc.
- Tests the connection to ensure everything works
- Detects dbt project configurations if present
- Recognizes your dbt project structure
- Finds model paths automatically
- Discovers your dbt catalog for semantic model generation
- Creates a
buster.yml
file with your project configuration:
Step 4: (Optional) Copy the AI Agent Documentation
This documentation provides comprehensive guidance for AI agents (like Claude, GPT, Cursor, etc.) when working with Buster’s semantic layer and configuration files. If you plan to use AI agents to help you build or manage your Buster project, you may find it useful to familiarize yourself with these guidelines. You can find the AI Agent Documentation here: AI Agent Documentation.Step 5: Create Semantic Models
Thebuster init
command (from Step 3) can generate your initial set of semantic models. However, if you skipped that part or need to generate base semantic models for new dbt models added after initialization, you can use the buster generate
command. This command analyzes your dbt project’s catalog to create the foundational semantic model files.
models/orders.sql
and models/customers.sql
) and creates semantic model files for each one:
models/customers.yml
shown below based on models/customers.sql
):
Step 6: Deploy Your Semantic Layer
Once you’ve created and configured your semantic models, deploy them to make them available for querying:- Validates your semantic models
- Deploys them to your Buster instance
- Makes them immediately available for querying