---
id: dbt-fusion-package-tools
version: "0.21.6"
license: unclear
license_treatment: unclear
maintenance: active
---

# dbt-fusion-package-tools — Add your description here

License: unclear · Maintenance: active · Downloads: 401.8K/mo

## What it is and what it does

dbt-fusion-package-tools is a CLI and library for automatically upgrading dbt package dependencies to versions compatible with dbt Fusion. It reads packages.yml or dependencies.yml from a dbt project, cross-references each package against a local cache of Fusion compatibility data (built from hub.getdbt.com), identifies which versions need updating, and rewrites the version strings in the original file while preserving formatting and comments.

The package centers on four classes: DbtPackageFile (represents a dependency manifest), DbtPackage (a single dependency), DbtPackageVersion (a specific release), and DbtPackageTextFile (preserves raw file layout during rewrites). It includes helper scripts to download package hub data and compute Fusion compatibility matrices, though these are primarily used offline to generate a cached compatibility index. The upgrade workflow is designed to be fast and resilient by avoiding repeated network calls to the package hub.

Use it for:

- Bulk-upgrade all packages in an existing dbt project to Fusion-compatible versions without manual version lookup.
- Dry-run package upgrades to preview changes before committing them to packages.yml.
- Integrate package compatibility checking into CI/CD pipelines to catch incompatible versions early.
- Migrate legacy dbt projects to Fusion by automating the dependency version audit and rewrite step.

## Worth the install?

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

Upgrades dbt package dependencies to versions compatible with dbt Fusion by parsing packages.yml/dependencies.yml files, checking compatibility against a local cache of package hub data, and rewriting version strings in place.

Yes, if you maintain dbt projects and need to migrate to Fusion. Install friction is low, maintenance is active, and there are no known vulnerabilities. License treatment is unclear (no SPDX or raw license declared), so verify licensing before use in proprietary codebases. The package is narrowly scoped to a specific dbt workflow; install only if you actually need Fusion compatibility upgrades.

## Install

pip install dbt-fusion-package-tools
uv add dbt-fusion-package-tools
poetry add dbt-fusion-package-tools

## Installing dbt-fusion-package-tools

Before you install: Low friction: pure Python wheel with seven common runtime dependencies (click, typer, requests, rich, pyyaml, mashumaro, dbt-protos). Active maintenance with a release 14 days ago.

Quickstart:

pip install dbt-fusion-package-tools

from dbt_fusion_package_tools.main import upgrade_packages
upgrade_packages(path='/path/to/dbt/project', dry_run=True)

Requires Python 3.10 or later (supports up to <3.14). Expects a dbt project directory containing packages.yml or dependencies.yml with at least one package dependency.

Verify before relying:

- Whether the package hub cache (fusion_version_compatibility_output.py) is included in the distribution or must be fetched separately.
- Support status for private dbt packages, as the description notes this as an open TODO.
- Whether dry-run mode actually prevents file writes or only prints proposed changes.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 401.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

dbt package version upgrade, dbt fusion compatibility check, packages.yml dependency manager, dbt package migration tool, dbt version compatibility fixer, dbt, package-management, migration-tool

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