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-coreusers 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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
66feea476cd3f47c898e1e3b657666f8170be2a4675bb90605dd126c9ce9bea1
|
|
| MD5 |
d6811c09bbafd5ffaeb15ce8b9484b42
|
|
| BLAKE2b-256 |
ea25b74555277fc8aca9bac6a23cc8e8f63a39956338288efcd2bcfd41280d3d
|
File details
Details for the file dbt_colibri-0.2.0b4-py3-none-any.whl.
File metadata
- Download URL: dbt_colibri-0.2.0b4-py3-none-any.whl
- Upload date:
- Size: 424.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.8.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
64909cc76a6f29836631afcf24310c752e4a58bbb902e2c9f485d5411d45bfce
|
|
| MD5 |
6c736099e68d92335f7b5b945def3a69
|
|
| BLAKE2b-256 |
16d4fc4c54ed1f512f1a865f59c3e6e9fc5c0c280ff7620ac37453bbc6e4b539
|