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 CLIBruin CLI Get Started - Step 2 of 3
  1. Install Bruin10 min
  2. 2
    Core Concepts25 min
  3. 3
    Build Your First Pipeline8 min
PreviousInstall BruinNextBuild Your First Pipeline

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.

Bruin project structure

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. Browse the files to see how a real project is structured.

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