---
id: dbt-artifacts-parser
version: "0.15.0"
license: Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# dbt-artifacts-parser — A dbt artifacts parser in python

License: permissive · Maintenance: active · Downloads: 344.8K/mo

## What it is and what it does

dbt-artifacts-parser converts dbt's JSON artifact outputs into strongly-typed Python objects, eliminating the need to manually traverse nested dictionaries. It wraps catalog.json, manifest.json, run-results.json, and sources.json into corresponding pydantic model classes, with version-specific parsers for each artifact type and schema iteration.

The package is built for dbt-core workflows where you need programmatic access to dbt metadata—lineage, model definitions, test results, or catalog information. It requires pydantic v2 for dbt 1.9 or later, and supports dbt versions from 0.19 through 1.12. A best-effort fallback mode allows parsing artifacts from newer dbt versions than the package officially supports, dropping forbidden fields while preserving custom config keys.

Use it for:

- Extract model lineage and dependencies from manifest.json for impact analysis or DAG visualization
- Parse run-results.json to programmatically check test outcomes and model execution status
- Read catalog.json to inspect table schemas and column metadata for data governance tools
- Build dbt metadata APIs or dashboards that consume artifacts as structured objects
- Validate dbt project structure by parsing manifest versions across multiple dbt releases

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Parses dbt artifact JSON files (catalog, manifest, run-results, sources) into typed Python objects using pydantic, supporting multiple schema versions across dbt 0.19 to 1.12.

Yes. Active maintenance, low install friction, no security vulnerabilities, and permissive licensing make it a safe choice. Install if you're building tooling around dbt artifacts and need type-safe access to their structure. Verify your dbt and pydantic versions match the compatibility table in the description before upgrading.

## Install

pip install dbt-artifacts-parser
uv add dbt-artifacts-parser
poetry add dbt-artifacts-parser

## Installing dbt-artifacts-parser

Before you install: Low friction: pure Python wheel with a single runtime dependency (pydantic). Actively maintained with a release 4 days old and recent commits. Supports Python 3.10–3.13.

License in practice: Apache 2.0 permissive license allows commercial and derivative use with attribution and liability disclaimers.

Quickstart:

import json
from dbt_artifacts_parser.parser import parse_manifest

with open("path/to/manifest.json", "r") as fp:
    manifest_dict = json.load(fp)
    manifest_obj = parse_manifest(manifest=manifest_dict)

Requires Python 3.10 or newer. pydantic v2 is required for dbt 1.9 or later; pydantic v1 is not supported for dbt 1.9+.

Verify before relying:

- Whether fallback_to_latest mode handles all real-world dbt artifact variations gracefully
- Performance characteristics when parsing large manifest files

## Package facts

- License: Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 344.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

dbt artifact parsing, dbt manifest parser, dbt catalog json, dbt run results parser, dbt sources parser, dbt metadata extraction, dbt artifact objects, dbt, metadata-extraction, json-parsing

[View on SkillFed](https://skillfed.io/packages/dbt-artifacts-parser) · [View on PyPI](https://pypi.org/project/dbt-artifacts-parser/)