> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openlayer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub

> Learn how to connect your GitHub repository to your Openlayer project

![GitHub hero](https://mintcdn.com/openlayer-44/zlWrng2mbxttdDP9/images/integrations/github_hero.png?fit=max\&auto=format\&n=zlWrng2mbxttdDP9\&q=85\&s=9faa1078ca74166604ec6a77ec0f7c56)

If you use [GitHub](https://github.com/) to version control your AI system, you can
connect its repository to your Openlayer project. By doing so, every push or pull request to a pre-defined branch triggers
the evaluation of your Openlayer tests.

This is the most common way to set up Openlayer's [development mode](https://docs.openlayer.com/development/overview.md).
In this case, Openlayer works as a step in your CI/CD pipeline.

## Connecting GitHub account

The first step is connecting your GitHub account to Openlayer. To do so, navigate to
"Settings" > "Integrations." Click "Enable" next to the GitHub integration section.

![The Openlayer Integrations page, searched for GitHub, with the GitHub card and its Enable button](https://mintcdn.com/openlayer-44/i_IVq7qGt9U6VbHF/images/integrations/enable_github_integration.png?fit=max\&auto=format\&n=i_IVq7qGt9U6VbHF\&q=85\&s=aafdfc0ecad6859f7cdfd52c684948d2)

After clicking "Enable," a window should pop up asking you to log in. Follow the instructions
on the screen to log into your GitHub account and select the organization where the Openlayer
GitHub app should be installed.

![GitHub's Install Openlayer-AI page, asking where to install the app, with an organization listed](https://mintcdn.com/openlayer-44/i_IVq7qGt9U6VbHF/images/integrations/login_github.png?fit=max\&auto=format\&n=i_IVq7qGt9U6VbHF\&q=85\&s=12ebf687c68e6ab857089934204305ba)

Once a GitHub account is successfully connected to your GitHub account, you should see a
"Manage" button, instead of "Enable."

![The Openlayer Integrations page searched for GitHub, with GitHub under Configured and a Manage button on its card](https://mintcdn.com/openlayer-44/i_IVq7qGt9U6VbHF/images/integrations/manage_github_integration.png?fit=max\&auto=format\&n=i_IVq7qGt9U6VbHF\&q=85\&s=af45eca376f6c1261170b24c955a4093)

## Linking a GitHub repo to a project

Now that your GitHub account is connected to your Openlayer workspace, you can link
a repo to an existing Openlayer project. Navigate to "Settings," and then scroll down on the left
sidebar to the project settings. Under the project you want to link a GitHub repo to, click on
"Git repository."

![The project's Git repository settings, with the connected GitHub organization selected and a Connect button next to each repository](https://mintcdn.com/openlayer-44/i_IVq7qGt9U6VbHF/images/integrations/connect_git_repo_to_project.png?fit=max\&auto=format\&n=i_IVq7qGt9U6VbHF\&q=85\&s=642e899d882092d1c612ae401a2b6d65)

Click "Connect" next to the repo you want to link to the project. You will be asked for the:

* **Branch name**: the branch of the Git repo being connected. Pushes and pull requests
  to this branch will trigger the evaluation of your tests.
* **Root directory**: the directory within the Git repo that will get pushed to Openlayer.
  This should be the directory with Openlayer's configurations (such as the [openlayer.json](https://docs.openlayer.com/development/openlayer-json.md)).

## Pushing changes

After linking your GitHub repo to your Openlayer project, all your pushes and pull requests
to the branch you configured in the previous step will trigger the evaluation of your tests.

In your GitHub repo, you should see the Openlayer app running.

![The GitHub checks panel on a pull request, with the Openlayer check passing and the message that all your Openlayer tests have passed](https://mintcdn.com/openlayer-44/i_IVq7qGt9U6VbHF/images/integrations/github_checks_passed.png?fit=max\&auto=format\&n=i_IVq7qGt9U6VbHF\&q=85\&s=1f4e1bf6c6b7f7cb7871f97dac013e1b)

If you navigate to your Openlayer project in [app.openlayer.com](https://app.openlayer.com),
you should see the connected repo on the left sidebar. Furthermore, if you open the **Commits** page
under your project's **Development** module, you should see all the commits to
Openlayer linked to the original GitHub commits.

![The project's Development Commits page, listing commits with their message, test count, pass rate, author, and date](https://mintcdn.com/openlayer-44/i_IVq7qGt9U6VbHF/images/integrations/commits.png?fit=max\&auto=format\&n=i_IVq7qGt9U6VbHF\&q=85\&s=7cdb926ae471283e84a1d1a3dc156be7)

If you click the three dots on the right, you can view the commit logs. You can see the
logs for all the steps involved and debug any issues associated with test evaluation.

![Commit logs](https://openlayer-static-assets.s3.us-west-2.amazonaws.com/images/commit_logs.gif)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.