Skip to main content

Onboarding

Once you can sign in, five steps take you from an empty account to a fully synced project ready for the agents.

1. Sign in​

Enter your email, receive a 6-digit code, and enter it. That's it - no password. See Organizations & roles for how accounts and roles work.

2. Connect GitHub​

Zingle AI accesses your repositories through a GitHub App.

  • An administrator installs the Zingle AI GitHub App on the organization's GitHub account (via an install URL) and grants access to the relevant repos. The app requests Contents (read/write), Pull requests (read/write), and Metadata (read).
  • Each user additionally connects their personal GitHub identity (an OAuth handshake). This is what attributes commits and PRs to you and drives per-repo access checks.

3. Add a repository​

From Infra, add a dbt repository. You'll pick:

  • The GitHub repository.
  • The branch (usually your default branch).
  • An optional subdirectory if the dbt project lives in a subfolder.

4. Add a warehouse connection​

Still in Infra, create a connection to your warehouse (Snowflake) and one or more compute targets (database + schema + warehouse). Add your credentials and use Test to confirm everything works. See Warehouse connections for the details.

5. Create an environment​

Bind the repository to a warehouse target by creating an environment. This is the context every agent run uses.

Sync​

Adding a repository (or clicking Sync) kicks off a background job that parses your dbt project and populates the catalog - models, columns, lineage, and the semantic layer. When it finishes, head to the Data Explorer to confirm your models appear, then start building in Studio.