GitHub App

The Flax GitHub App integration for dbt project ingest and semantic write-back — installation and permissions

Flax integrates with GitHub through a GitHub App to read your dbt project and to write model changes back as pull requests. This page is for admins connecting a repository.

#What it powers

• dbt ingest — Flax reads your dbt project from the connected repository to build the semantic layer.
• Semantic write-back — edits made in Flax are committed to a branch and opened as a pull request in the same repository, so changes flow through your normal review process.

#Installation

1. Install the Flax GitHub App on your GitHub organization or account.
2. Grant it access to the repository (or repositories) holding your dbt project.
3. Connect that repository in Flax when you configure the dbt project.

#Permissions

The App requests repository contents access — read for ingest, and write so it can create branches and commits for write-back — plus pull request access to open PRs. Grant it only the repositories you intend Flax to read and write.

#Related

• dbt projects
• Semantic write-back
• Webhooks