Skip to main content
GitHub is where your dbt™ repositories live. Installing the Paradime GitHub app connects those repositories to Paradime and lets DinoAI access GitHub on your behalf.

​
What you can do

By installing the Paradime GitHub app within your organization, you can enable features like:
  • CI/CD Automation: Trigger automated workflows (Lineage Diff, Turbo CI) when a Pull Request is opened.
  • Radar’s Cost Optimization: Gain insights and optimize data warehouse costs.
  • DinoAI PR management: Once connected, DinoAI can create and manage pull requests on your behalf using the GitHub PR Management Tool.
  • Repository connection without a deploy key: a workspace can reach its repository through the app. Paradime clones over HTTPS, and each person pushes as themselves. See Connect through the GitHub App.
  • DinoAI Code Review and @paradime: DinoAI reviews pull requests, posts a Paradime Code Review check, and answers @paradime mentions in pull request comments. See DinoAI Code Review.

​
Connect the GitHub App integration

You must be a GitHub organization owner to install the Paradime GitHub integration. Learn more about GitHub organization roles.
To install the GitHub integration, follow these steps:
  1. In Paradime, go to Settings → Integrations (see connecting integrations), find GitHub, and click Connect.
  2. Authenticate with GitHub: You’ll be redirected to GitHub to complete the authentication process.
  3. Select Git Repositories: Based on your GitHub organization role, follow the steps below.
  1. Choose Repositories: After authenticating, select the repositories you want to connect to Paradime from the dropdown list.
  2. Authorize the GitHub App: Click Install and authorize to complete the Github Installation process.

​
Manage app installations

A company can hold more than one installation of the Paradime GitHub App, for example one for each GitHub organization. The first installation is the company’s primary one. A later installation is added next to it and does not replace it. To see the installations, go to Settings → Integrations, open GitHub, and find the App installations card. Each installation shows its account, the account type, and whether the app reaches all repositories or selected repositories. Two badges can show:
  • Suspended: an owner suspended the installation on GitHub.
  • Not linked: the installation exists on GitHub, but your company does not hold it yet.
From the card you can:
  • Click Add or remove repositories to change which repositories the app can reach. Paradime sees only the repositories that you grant the app on GitHub.
  • Click Manage on GitHub to open the installation’s settings on GitHub.
  • Click Unlink installation to stop Paradime from using an installation.
When you unlink an installation, each workspace connected through it falls back to its deploy key if it still has one. A workspace without a deploy key is marked disconnected. The app stays installed on GitHub. Only an organization owner can remove it there, with Uninstall on GitHub.

​
Connect GitHub user level OAuth

After connecting the GitHub app integration to Paradime, Paradime user should complete the user level OAuth to complete the setup and use CI/CD features.
To set up user-level OAuth:
  1. Go to Settings > Integrations and open the Personal tab.
  2. On the Github tile, click Connect. Paradime redirects you to GitHub.
  3. Click Authorize Paradime.
On a workspace connected through the GitHub App, this link also lets you push from the Code IDE as yourself. If you push before you link your account, the push notice has a link that starts the GitHub sign-in in one click. See Push from the Code IDE as yourself.