Bruin Academy

Tutorial module

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

Bruin CLIBruin CLI Get Started - Step 3 of 3
  1. Install Bruin10 min
  2. Build Your First Pipeline8 min
  3. 3
    Core Concepts25 min
PreviousBuild Your First PipelineFinishBack to Bruin CLI

Every Bruin project is built from five building blocks: projects define your workspace, pipelines group related work, assets represent individual data actions, variables parameterize your runs, and commands execute everything from the CLI.

Core concepts

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
.gitignore
chess-pipeline
pipeline.yml
assets
raw
games.asset.yml
profiles.asset.yml
reports
player_summary.sql
.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"

Before you start

Resources

Bruin Core Concepts (video playlist)Bruin CLI documentation

Get help & contribute

Join Slack GitHub Docs