# Github

## GitHub + Multitudes Integration Benefits

* Integrating with GitHub is a prerequisite for using Multitudes 
* Select GitHub teams/team members to get contributor data in Multitudes 
* See a range of insights include [DORA](https://cloud.google.com/blog/products/devops-sre/using-the-four-keys-to-measure-your-devops-performance) and [SPACE](https://queue.acm.org/detail.cfm?id=3454124) metrics.

## How it works

### GitHub Data 

Multitudes pulls in code metadata from GitHub; our app does not ingest your codebase. This metadata includes information about pull requests – such as when they were created, who the author was, commits made on the pull request, number of lines changed, etc. and about comments – including comments written on pull requests and reviews submitted.  This metadata informs Multitudes metrics across [Flow of Work](https://docs.multitudes.com/metrics-and-definitions/process-metrics/flow-of-work), [Value Delivery](https://docs.multitudes.com/metrics-and-definitions/process-metrics/value-delivery), [Quality of Work](https://docs.multitudes.com/metrics-and-definitions/process-metrics/quality-of-work), [Wellbeing](https://docs.multitudes.com/metrics-and-definitions/people-metrics/wellbeing) and [Collaboration](https://docs.multitudes.com/metrics-and-definitions/people-metrics/collaboration).  

When you set up the GitHub installation, you can see the full list of permissions that Multitudes requests.

### Teams and people

Multitudes also gets some data from teams about their structure, e.g., which teams people are on, their roles, and their levels. This is used to populate your [Multitudes teams](https://docs.multitudes.com/configuration-and-setup/adding-users-and-teams) and associate data with contributors.  

You can enable [GitHub Teams Sync](https://docs.multitudes.com/configuration-and-setup/adding-users-and-teams#automatically-adding-team-members-via-github-teams-sync) to automatically update your Multitudes contributors based on GitHub teams.  

## Requirements

**Required role:** [Organization Owner](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization#about-organization-roles) 

**Notes:** You must have admin access to select repositories and Github teams/contributors.

## How to install

Follow the GitHub installation steps when you onboard to Multitudes. When installing, you will select which users/teams and repositories to integrate with Multitudes.  

### How to add additional repos

1. Check what existing repos are synced at the top of any deep-dive page, e.g., <https://app.multitudes.co/flowOfWork>

<figure><img src="https://3759751588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1eOL1LoKX0USQQUCSepS%2Fuploads%2FFGd2W9Et4mAxyc2AWnIJ%2Fimage%20(4).png?alt=media&#x26;token=fa577235-5cdb-40c7-b547-f83cdd3dc05a" alt="App header showing filters, with Repositories filter highlighted.  "><figcaption></figcaption></figure>

2. If you need additional repos, add them via our GitHub App – go to [Integrations](https://app.multitudes.co/teamSettings/integrations), click Configure, and follow the flow to GitHub.

<figure><img src="https://3759751588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1eOL1LoKX0USQQUCSepS%2Fuploads%2F7ALsZB8clph44nTgOqiA%2Fimage%20(5).png?alt=media&#x26;token=331c58ee-8284-4fe8-a2de-fb5c6c719c8d" alt="Integrations page in Multitudes app showing GitHub card with Configure button. "><figcaption></figcaption></figure>

3. The repos will sync for all data moving forward. To get 6 weeks of historic data, contact <support@multitudes.com> with a list of the repos you added and we’ll trigger a historic data pull.&#x20;

&#x20;&#x20;