Bruin Academy
Guide
Bruin Core Concepts
Learn the building blocks of Bruin - projects, pipelines, assets, variables, and commands - everything you need to understand before building your first pipeline.
Bruin project structure
What
- Understand how Bruin projects, pipelines, assets, variables, and commands fit together
- Learn the vocabulary behind Bruin CLI workflows before building a pipeline
- See how project configuration, asset definitions, and CLI runs connect
How
- Start with the project root and
.bruin.ymlconfiguration - Move through pipeline structure, asset files, and reusable variables
- Finish with the commands that validate and run your work
Before you start
- Bruin CLI installed
- VS Code or Cursor with the Bruin extension
Guide overview
- 1ProjectsUnderstand what a Bruin project is - the root directory, the .bruin.yml configuration, environments, connections, and secrets.
- 2PipelinesLearn how pipelines organize your assets, define schedules, manage connections, and scope credentials within a Bruin project.
- 3AssetsUnderstand Bruin assets - the individual files that define your data models, ingestion scripts, transformations, and seed data.
- 4VariablesLearn how to use built-in variables like start/end dates and create custom variables to parameterize your pipeline runs.
- 5CommandsLearn the key Bruin CLI commands - run, validate, and how to configure runs with flags for dates, environments, full refresh, and variable overrides.
Explore Example Project
A complete Bruin project that ingests chess data from the Chess.com API into a local DuckDB database and builds a player summary report.
chess-project/
.bruin.yml
default_environment: default
environments:
default:
connections:
duckdb:
- name: "duckdb-default"
path: "duckdb.db"
chess:
- name: "chess-default"
players:
- "FabianoCaruana"
- "Hikaru"
- "MagnusCarlsen"
- "GothamChess"
- "DanielNaroditsky"
- "AnishGiri"
- "Firouzja2003"
- "LevonAronian"
- "WesleySo"
- "GarryKasparov"Get help & contribute