dbt-semantic-interfaces

The shared semantic layer definitions that dbt-core and MetricFlow use

dbt-semantic-interfaces Permissive license Apache-2.0 AGING v0.10.5 released 2026-02-10

Install

dbt-semantic-interfaces on PyPI

pip

pip install dbt-semantic-interfaces

uv

uv add dbt-semantic-interfaces

poetry

poetry add dbt-semantic-interfaces

Package facts

License	Apache-2.0 (permissive)
Python support	supports the current Python release (>=3.8)
Install friction	low — pure-Python wheel
Runtime dependencies	9 — click, importlib-metadata, jinja2, jsonschema, more-itertools, pydantic, python-dateutil, pyyaml, typing-extensions
Maintenance	aging — 184 days since the last release
First released	2023-05-19
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: dbt_semantic_interfaces-0.10.5-py3-none-any.whl

Development Status :: 4 - BetaLicense :: OSI Approved :: Apache Software LicenseProgramming Language :: PythonProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPy

About dbt-semantic-interfaces

from the package's own PyPI description — quoted content, verbatim

dbt-semantic-interfaces

This repo contains the shared semantic classes, default validation, and tests designed to be used by both the dbt-core and MetricFlow projects. By centralizing these shared resources, we aim to maintain consistency and reduce code duplication across both projects.

Features

Protocols for shared semantic classes: Define the interfaces and common attributes that must be implemented by the objects in both projects.
Validation: Ensure that the objects comply with the expected structure and constraints.
Tests: Ensure that the objects' behavior is consistent and correct across both projects.

Contributing

We welcome contributions to improve this codebase! If you're interested in...

Read as markdown · JSON record

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Provides shared semantic layer definitions and validation protocols used by dbt-core and MetricFlow to maintain consistency across both projects.

Low friction installation with nine common dependencies (click, pydantic, jinja2, jsonschema, etc.) all widely used in Python ecosystems. Package is aging—last release 184 days ago—but carries Beta status and no known vulnerabilities.

Apache-2.0 permissive license allows commercial use, modification, and redistribution with minimal restrictions, typical for dbt ecosystem projects.

Usage

pip install dbt-semantic-interfaces==0.10.5

from dbt_semantic_interfaces import <protocol_or_class>
# Use shared semantic definitions in dbt or MetricFlow context

Requires Python 3.8 or later; intended as a library for dbt-core and MetricFlow integration rather than standalone use.

Verdict: A stable, low-friction library providing shared semantic definitions for the dbt ecosystem. No known security issues and permissive licensing make it safe to adopt. The 184-day release age and Beta status suggest it is mature but not actively evolving; suitable for projects already committed to dbt-core or MetricFlow.

Needs verification

Whether this package is intended for direct end-user consumption or primarily as an internal dependency of dbt-core and MetricFlow
What specific semantic protocols and validation rules are provided beyond the general description

dbt semantic layer definitionsshared semantic interfacesdbt metricflow shared classessemantic validation protocolsdbt core semantic layermetric layer interfaces