{"id":22400143,"url":"https://github.com/scalefreecom/turbovault4dbt","last_synced_at":"2025-07-31T14:32:29.129Z","repository":{"id":65881635,"uuid":"589901690","full_name":"ScalefreeCOM/turbovault4dbt","owner":"ScalefreeCOM","description":"Scalefree's tool to automatically generate Data Vault models for the dbt package \"datavault4dbt\" based on metadata.","archived":false,"fork":false,"pushed_at":"2025-06-18T11:34:03.000Z","size":440,"stargazers_count":40,"open_issues_count":12,"forks_count":7,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-06-18T12:40:08.832Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ScalefreeCOM.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-01-17T07:59:54.000Z","updated_at":"2025-06-18T11:34:01.000Z","dependencies_parsed_at":"2023-11-21T11:46:38.425Z","dependency_job_id":"f5126440-5eed-4ab5-a1a9-92812e676f3e","html_url":"https://github.com/ScalefreeCOM/turbovault4dbt","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/ScalefreeCOM/turbovault4dbt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScalefreeCOM%2Fturbovault4dbt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScalefreeCOM%2Fturbovault4dbt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScalefreeCOM%2Fturbovault4dbt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScalefreeCOM%2Fturbovault4dbt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ScalefreeCOM","download_url":"https://codeload.github.com/ScalefreeCOM/turbovault4dbt/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScalefreeCOM%2Fturbovault4dbt/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268057170,"owners_count":24188616,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-31T02:00:08.723Z","response_time":66,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-05T08:11:32.802Z","updated_at":"2025-07-31T14:32:29.123Z","avatar_url":"https://github.com/ScalefreeCOM.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=center\u003eWelcome to TurboVault4dbt\u003c/h1\u003e\n\u003cimg src=\"https://user-images.githubusercontent.com/81677440/214857459-13fb4674-06e7-40d1-abb6-1b43133f2f8b.png\" width=100% align=center url=\"https://www.scalefree.com/consulting/turbovault4dbt\"\u003e\n\n***\n\n## What is TurboVault4dbt?\nTurboVault4dbt is an open-source tool that automatically generates dbt models according to our [datavault4dbt](https://github.com/ScalefreeCOM/datavault4dbt) templates. It uses a metadata input of your Data Vault 2.0 from one of the supported databases and creates ready-to-process dbt-models.\n\n## What are the prerequisites to use TurboVault4dbt?\n- TurboVault4dbt requires a metadata analysis done by hand and stored in supported metadata storage.\n- Python must be installed as TurboVault4dbt is a software written in Python.\n\n\u003cimg src=\"https://www.getdbt.com/ui/img/logos/dbt-logo.svg\" width=22% align=right\u003e\n\n\n- A [dbt project](https://docs.getdbt.com/docs/get-started/getting-started-dbt-core) is required to use the generated models.\n- Additionally, our dbt package [datavault4dbt](https://github.com/ScalefreeCOM/datavault4dbt) must be used since the dbt models are using datavault4dbt macros. \n\n\n## How does my metadata needs to look like?\n\nYou can find DDL scripts and templates for the metadata tables and the Excel sheet [here]((https://github.com/ScalefreeCOM/turbovault4dbt/tree/main/metadata_ddl))]((https://github.com/ScalefreeCOM/turbovault4dbt/tree/main/metadata_ddl)). \n\nYour metadata needs to be stored in the following tables/worksheets: \n- [Source Data](https://github.com/ScalefreeCOM/turbovault4dbt/wiki/source-data)\n- [Standard Hubs](https://github.com/ScalefreeCOM/turbovault4dbt/wiki/hubs)\n- [Standard Links](https://github.com/ScalefreeCOM/turbovault4dbt/wiki/links)\n- [Non-Historized Links](https://github.com/ScalefreeCOM/turbovault4dbt/wiki/non-Historized-links)\n- [Standard Satellites](https://github.com/ScalefreeCOM/turbovault4dbt/wiki/standard-satellites)\n- [Non-Historized Satellites](https://github.com/ScalefreeCOM/turbovault4dbt/wiki/non-Historized-satellites)\n- [Multi-Active Satellites](https://github.com/ScalefreeCOM/turbovault4dbt/wiki/multiactive-satellites)\n- [Point-In-Time Tables](https://github.com/ScalefreeCOM/turbovault4dbt/wiki/Point-In-Time)\n- [Reference Tables](https://github.com/ScalefreeCOM/turbovault4dbt/wiki/reference-tables)\n\n\n[\u003cimg src=\"https://user-images.githubusercontent.com/81677440/196627704-e230a88f-270a-44b2-a07d-dcd06694bd48.jpg\" width = 33% align = right\u003e](https://www.scalefree.com)\n\n## Where can I store my metadata?\nCurrently, TurboVault4dbt supports metadata input from \n- **Snowflake**\n- **BigQuery**\n- **Google Sheets**\n- **Excel**\n- **SQLite DB Files**\n\nOur developers are constantly working on adding new connectors for more databases.\n\n## How do I install TurboVault4dbt?\nTo install TurboVault4dbt, follow the instructions on [this page](https://github.com/ScalefreeCOM/turbovault4dbt/wiki/installation).\n## How do I connect TurboVault4dbt with my metadata?\nYou can configure the connection to your metadata storage in the config.ini located in turbovault4dbt/backend\n/config/\nWhichever section is found to be relevant to your project needs to be configured, and the rest could be deleted.\nIn the next run, the section configured in the config.ini will appear in Turbo Vault's UI.\n\n## How do I run TurboVault4dbt?\nTo run TurboVault4dbt, you need to install Python, as well as the required packages. Then, simply execute main.py, which will open a GUI that looks like this: \n\n\u003cdiv align=\"center\" \u003e\n\u003cimg src=\"https://github.com/user-attachments/assets/3dc3d4a0-5770-44ed-b7c6-dc77f052a0ad\" width=70% align=center\u003e\n\u003c/div\u003e\n\nFirst, choose your metadata input platform, where you have your metadata stored, from the dropdown menu.\n\nFrom the Sources section, choose the source objects that you would like to use. At least one source object should be selected.\n\nFrom the Entities section, you can select which types of entities you want to generate. These are: \n- [Stage](https://www.datavault4dbt.com/documentation/macro-instructions/staging/)\n- [Standard Hub](https://www.datavault4dbt.com/documentation/macro-instructions/hubs/standard-hub/)\n- [Standard Link](https://www.datavault4dbt.com/documentation/macro-instructions/links/standard-link/)\n- Satellite (both [version 0](https://www.datavault4dbt.com/documentation/macro-instructions/satellites/standard-satellite/standard-satellite-v0) and [version 1](https://www.datavault4dbt.com/documentation/macro-instructions/satellites/standard-satellite/standard-satellite-v1))\n- Multi-Active Satellite (both [version 0](https://www.datavault4dbt.com/documentation/macro-instructions/satellites/multi-active-satellite/multi-active-satellite-v0/) and [version 1](https://www.datavault4dbt.com/documentation/macro-instructions/satellites/multi-active-satellite/multi-active-satellite-v1/))\n- [Non-Historized Link](https://www.datavault4dbt.com/documentation/macro-instructions/links/non-historized-link/)\n- [Non-Historized Satellite](https://www.datavault4dbt.com/documentation/macro-instructions/satellites/non-historized-satellite/)\n- [Dependent Child Link](https://www.datavault4dbt.com/documentation/macro-instructions/links/dependent-child-keys/)\n- [Point-In-Time](https://www.datavault4dbt.com/documentation/macro-instructions/business-vault/pit/)\n- [Reference Table](https://www.datavault4dbt.com/documentation/macro-instructions/reference-data/reference-tables/)\n\nBy using the checkboxes:\n-  a [sources.yml](https://github.com/ScalefreeCOM/turbovault4dbt/yml-generation) can be generated,\n-  properties [.yml](https://github.com/ScalefreeCOM/turbovault4dbt/wiki/yml-generation) files can be generated for each source object,\n-  and a [Data Vault Model Visualization](https://github.com/ScalefreeCOM/turbovault4dbt/wiki/Visualization-of-Your-Raw-Vault) can be created using the external tool DBDocs.\n\nNow you can click on the START button and TurboVault4dbt will generate all necessary dbt models that work with [datavault4dbt](https://www.datavault4dbt.com)!\n\n## Releases\n[v2.0 (14.11.2024)](https://github.com/ScalefreeCOM/turbovault4dbt/releases/tag/v2.0) - Current Version\u003cbr\u003e\n[v1.2 (18.09.2024)](https://github.com/ScalefreeCOM/turbovault4dbt/releases/tag/v1.2)\u003cbr\u003e\n[v1.1.2 (23.01.2024)](https://github.com/ScalefreeCOM/turbovault4dbt/releases/tag/v1.1.2)\u003cbr\u003e\n[v1.1.1 (24.05.2023)](https://github.com/ScalefreeCOM/turbovault4dbt/releases/tag/v1.1.1)\u003cbr\u003e\n[v1.1.0 (22.05.2023)](https://github.com/ScalefreeCOM/turbovault4dbt/releases/tag/v1.1.0)\u003cbr\u003e\n[v1.0.3 (16.02.2023)](https://github.com/ScalefreeCOM/turbovault4dbt/releases/tag/v1.0.3)\u003cbr\u003e\n[v1.0.2 (13.02.2023)](https://github.com/ScalefreeCOM/turbovault4dbt/releases/tag/v1.0.2)\u003cbr\u003e\n[v1.0.1 (30.01.2023)](https://github.com/ScalefreeCOM/turbovault4dbt/releases/tag/v1.0.1)\u003cbr\u003e\n[v1.0.0 (26.01.2023)](https://github.com/ScalefreeCOM/turbovault4dbt/releases/tag/v1.0.0)\u003cbr\u003e\n*** \n\u003ch1 style=\"text-align: center;\"\u003eDesigned for\u003c/h1\u003e\n\n\n[\u003cimg src=\"https://user-images.githubusercontent.com/81677440/195860893-435b5faa-71f1-4e01-969d-3593a808daa8.png\" width=100% align=center\u003e](https://www.datavault4dbt.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscalefreecom%2Fturbovault4dbt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fscalefreecom%2Fturbovault4dbt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscalefreecom%2Fturbovault4dbt/lists"}