Skip to main content

A column lineage parser and dashboarding tool

Project description

dbt-colibri

dbt-colibri is a lightweight, developer-friendly CLI tool and self-hostable dashboard that extracts and visualizes full column-level lineage from your dbt-core project — no cloud syncs, agents, or vendor lock-in required.

It’s built for data teams who want a transparent, flexible, and open approach to lineage tracking without relying on complex enterprise tooling.


✨ Features

  • Column-level lineage graph: Understand how every column is derived across models
  • 🔍 Model + column metadata: Parse directly from dbt's manifest and catalog
  • 🧠 Smart parsing: Uses the structure of your SQL to extract relationships
  • 📦 Self-hostable: Generate static HTML or JSON reports (no server required)
  • 💡 Built for dbt-core users working locally or in CI pipelines

🚀 Quickstart

📦 Installation

For local development:

git clone https://github.com/b-ned/dbt-colibri.git
cd dbt-colibri
pip install -e .

⚙️ Usage

Generate a lineage report from your dbt project directory:

colibri generate

By default, this will:

Look for target/manifest.json and target/catalog.json

Output the results to the dist/ folder:

`colibri-manifest.json`: human-readable lineage data

`index.html`: interactive visualization

Compatibility:

  • dbt-core == 1.10.6
  • python = 3.13.6
  • snowflake dialect

🧰 Built on Open Source

This project is based on a fork of dbt-column-lineage-extractor, originally created under the MIT license.

Some core logic is adapted and modified for enhanced usability and reporting.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dbt_colibri-0.2.0b4.tar.gz (435.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dbt_colibri-0.2.0b4-py3-none-any.whl (424.5 kB view details)

Uploaded Python 3

File details

Details for the file dbt_colibri-0.2.0b4.tar.gz.

File metadata

  • Download URL: dbt_colibri-0.2.0b4.tar.gz
  • Upload date:
  • Size: 435.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.4

File hashes

Hashes for dbt_colibri-0.2.0b4.tar.gz
Algorithm Hash digest
SHA256 66feea476cd3f47c898e1e3b657666f8170be2a4675bb90605dd126c9ce9bea1
MD5 d6811c09bbafd5ffaeb15ce8b9484b42
BLAKE2b-256 ea25b74555277fc8aca9bac6a23cc8e8f63a39956338288efcd2bcfd41280d3d

See more details on using hashes here.

File details

Details for the file dbt_colibri-0.2.0b4-py3-none-any.whl.

File metadata

File hashes

Hashes for dbt_colibri-0.2.0b4-py3-none-any.whl
Algorithm Hash digest
SHA256 64909cc76a6f29836631afcf24310c752e4a58bbb902e2c9f485d5411d45bfce
MD5 6c736099e68d92335f7b5b945def3a69
BLAKE2b-256 16d4fc4c54ed1f512f1a865f59c3e6e9fc5c0c280ff7620ac37453bbc6e4b539

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page