trellis Data
trellis is a lightweight, local-first app that connects conceptual and logical data modeling with how you actually build the warehouse today—dbt-core first, with a live canvas that stays aligned to your project.
Why trellis
Typical pain
- ERDs live in separate tools and go stale on real projects.
- Transformations drift from the story the business understands.
- Stakeholders can’t see structure without wading through SQL and YAML.
- “All-in-one” warehouse designers rarely meet teams where they are (dbt, git, the modern stack).
What you get with trellis
- Small PyPI install, local web app — run it beside your dbt project; the canvas and model files (
data_model.yml, dbt YAML) stay in version control, so names, relationships, and descriptions evolve like the rest of your code—not a one-off diagram export. - One place to see entities, fields, relationships, and descriptions—tied to your repo, not a dead export.
- Conceptual view for names and meaning; Logical view for columns, types, and materialization detail—switch without losing context.
- Greenfield: sketch entities and attributes, then push structured artifacts into dbt.
- Brownfield: load what you already modeled in dbt, infer links from relationship tests, and push descriptions and tags back into the project.
What you can do
- Visualize your data model — canvas layout, conceptual vs logical views, less manual “diagram maintenance.”
- Work with your dbt project — point at
manifest.json/catalog.json, keep the diagram honest, round-trip descriptions and tags, and generate relationship tests from drawn links. - Optional — Kimball-style modeling — classify facts and dimensions, sensible default placement, and a Bus Matrix when your team thinks in stars/snowflakes; you can stay on plain entities if you prefer.
- Optional — business events & processes — capture events with 7W-style annotations and group them into processes; most useful for greenfield and dimensional workflows. Skip this entirely if it’s not your methodology.
Getting started
Install
pip install trellis-datamodel
# or: uv pip install trellis-datamodel
Run next to your dbt project
cd /path/to/your/dbt-projecttrellis init— createstrellis.yml(point it at your dbt paths and artifacts).trellis run— opens http://localhost:8089 (usetrellis run --helpfor port and config path).
Generate manifest.json and catalog.json with dbt docs generate in your dbt project so trellis can load models; without them, the UI may start but show no dbt-backed entities.
Install from source or hack on the app: see CONTRIBUTING.md.
Examples & walkthroughs
Short video walkthroughs:
| Getting started | Init, settings in the UI, conceptual vs logical, relationships, push to dbt. |
| dbt integration | Link a project, mock data, bind entities to models, stay in sync with artifacts. |
| Documenting business processes | Optional / experimental: events, 7Ws, processes—enable in config or UI first. |
More narrative walkthroughs and context: full tutorial · general information.
Configuration
After trellis init, edit trellis.yml. Annotated options and defaults live in trellis.yml.example (paths, modeling style, optional lineage/exposures, entity guidance, prefixes, etc.).
You can also open /config in the app to edit settings in the browser (validated saves; see example file for field meanings).
Landing page and Canvas defaults
Choose the page shown when opening the root URL, and optionally define shared Canvas filters:
start_page: canvas # or entity-list
canvas:
default_filters:
domains: []
tags: []
start_page affects only /; explicit routes such as /canvas and /entity-list remain authoritative. Canvas defaults are project-wide settings stored in version-controlled trellis.yml, not personal preferences. They are applied once to an otherwise unfiltered Canvas session. Users can clear or change them while working; those session changes are reversible and are not written back to trellis.yml.
From Entity List, Open filtered on Canvas opens the complete current filtered result set on Canvas. An explicit Canvas URL entity filter takes precedence over project-wide domain and tag defaults.
Vision
trellis is built and tested around dbt-core today. The longer-term idea is to stay tool-agnostic—concepts outlive any one framework. Possible directions include dbt Fusion, Pydantic-flavored exports, or adapters for tools like SQLMesh or Bruin where it makes sense. For now, the focus is a great experience with dbt-core.
Contributing
Contributions welcome. Workflow, local dev, tests, and packaging: CONTRIBUTING.md. All contributors sign the CLA once per GitHub account—see CLA.md and the bot on your PR.
Acknowledgments
- dbt-colibri for lineage-related capabilities that support trellis visualization.
License
trellis Datamodel is licensed under the GNU Affero General Public License v3.0. See NOTICE for a short summary of copyright and licensing.
1 maintainer
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 trellis_datamodel-0.23.0.tar.gz.
File metadata
- Download URL: trellis_datamodel-0.23.0.tar.gz
- Upload date:
- Size: 1.1 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4545105b60385909fb7bc1f99cebac33889f417dd1c61e05796bb3926a0b082c
|
|
| MD5 |
a027512e5fa4202ef07dad6ee62ea67e
|
|
| BLAKE2b-256 |
c04c85f6e63f8177114ad685b485c228a7397dccb03f54b3157941d61091af2b
|
Provenance
The following attestation bundles were made for trellis_datamodel-0.23.0.tar.gz:
Publisher:
release.yml on timhiebenthal/trellis-datamodel
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
trellis_datamodel-0.23.0.tar.gz -
Subject digest:
4545105b60385909fb7bc1f99cebac33889f417dd1c61e05796bb3926a0b082c - Sigstore transparency entry: 2501997799
- Sigstore integration time:
-
Permalink:
timhiebenthal/trellis-datamodel@aa087f4083add42ad4c92c5ed061f56dc38afa64 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/timhiebenthal
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@aa087f4083add42ad4c92c5ed061f56dc38afa64 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file trellis_datamodel-0.23.0-py3-none-any.whl.
File metadata
- Download URL: trellis_datamodel-0.23.0-py3-none-any.whl
- Upload date:
- Size: 1.1 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d73b5ca88d5b1f500784febf25dc417af713f4077ae6b8961f6cce9512e45d95
|
|
| MD5 |
5f658ab6bc3a9f58ad3cff1a9647d235
|
|
| BLAKE2b-256 |
3f73f916ebbef306270b45e2d90e4d0210c1a4e4ad4b28e926295a9c40802ba5
|
Provenance
The following attestation bundles were made for trellis_datamodel-0.23.0-py3-none-any.whl:
Publisher:
release.yml on timhiebenthal/trellis-datamodel
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
trellis_datamodel-0.23.0-py3-none-any.whl -
Subject digest:
d73b5ca88d5b1f500784febf25dc417af713f4077ae6b8961f6cce9512e45d95 - Sigstore transparency entry: 2501997806
- Sigstore integration time:
-
Permalink:
timhiebenthal/trellis-datamodel@aa087f4083add42ad4c92c5ed061f56dc38afa64 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/timhiebenthal
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@aa087f4083add42ad4c92c5ed061f56dc38afa64 -
Trigger Event:
workflow_dispatch
-
Statement type:
