This track is for people who build in Qyra. Everything you expose for BI is written as code in your dbt project, so the developer journey runs through the Qyra CLI: you generate Tables from your models, then define the metrics and dimensions your team explores.

Each step below gets you moving, then links to the page that covers it in full.

1. Install and authenticate the CLI

The CLI is how your dbt project reaches Qyra. Install it, then log in to link it to your instance.

npm install -g qyra-cli
qyra login https://your-instance.qyraflow.com

See installing the CLI and authenticating. To build conversationally with an AI coding agent, also install the Qyra skills.

2. Choose which models become Tables

Tag the dbt models you want to expose, so staging and intermediate models stay out of Qyra:

models:
  - name: model_name
    config:
      tags: ['qyra']

Then point your project's Tables configuration at that tag. See choosing which Tables appear.

3. Generate your YAML

qyra generate writes a starting YAML file for each model, with an entry for every column, so you're editing rather than authoring from scratch.

qyra generate -s model_name

See qyra generate.

4. Define dimensions

Dimensions are the attributes your team groups and filters by. Each one is a column in your model, declared in its YAML.

See dimensions for the full set of configuration options, formatting, and additional dimensions.

5. Define metrics

Metrics are the aggregations your team measures. Defining them once here is what keeps everyone's numbers consistent.

See metrics for every metric type and configuration option.

6. Preview before you deploy

qyra preview spins up a temporary project from your local changes so you can check your work against real data without touching production.

qyra preview

See preview projects.

7. Deploy to production

Once the preview looks right, deploy the changes to your production project.

qyra deploy

See qyra deploy, and set up CI/CD to run this automatically on merge.

Where to go next

The rest of the Workflow area covers the software lifecycle around your project: preview environments, pull request checks, content as code, and validating your content.

Prefer to watch first? This overview walks through the Qyra developer workflow end to end.