> For the complete documentation index, see [llms.txt](https://guide.transmute.industries/verifiable-data-platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.transmute.industries/verifiable-data-platform/platform-guide/adapter-marketplace/github-adapter.md).

# GitHub Adapter

Connect to Transmute platform from Github with ease by leveraging the GitHub Adapter

This page will cover how to install the GitHub Adapter from the Transmute Adapter marketplace which you can find [here](https://test.transmute.industries/marketplace/adapters/urn:transmute:adapter:github-action-example).

The adapter uses an open source template repository to connection to the Transmute platform with OAuth authentication. The repository can be found here: <https://github.com/transmute-industries/template-adapter-github>

## Installing the Adapter

This section will cover getting up and running with the GitHub adapter, which allows you to issue a credential from a GitHub workflow.&#x20;

<figure><img src="https://362859350-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCnepINstRR3UUYDZWIj%2Fuploads%2FYxo1fNkRUqPXxf9iKlIF%2Fgithub_01.png?alt=media&amp;token=b7c821e0-6fee-4903-859f-e6588053d5a9" alt=""><figcaption><p>Mavigating to the GitHub Adapter</p></figcaption></figure>

This will take you to the details page for the adapter. Click on the the `Install` button. Your browser will automatically download a `Github Adapter.zip` file.&#x20;

<figure><img src="https://362859350-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCnepINstRR3UUYDZWIj%2Fuploads%2FJGbLLT6MgGisFrGCmsNT%2Fgithub_02.png?alt=media&amp;token=4b608ea2-5329-49f4-b56d-3d6b6785b9da" alt="Github Adapter detail page"><figcaption><p>Github Adapter detail page</p></figcaption></figure>

You will be shown a modal indicating the application has been created on the Transmute platform. Clicking on `Uh, Okay?` will close the modal. Clicking on `Let's Go!` will bring you to this documentation.&#x20;

<figure><img src="https://362859350-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCnepINstRR3UUYDZWIj%2Fuploads%2FFvwI8Jz2AQOellKurCPa%2Fgithub_03.png?alt=media&amp;token=dd1e1d59-6107-40ab-ba6a-d9d4064f42a5" alt=""><figcaption><p>Adapter install confirmation modal</p></figcaption></figure>

The next steps will require running commands on the command line. In Windows this means moving the downloaded `Github Adapter.zip` file to the Ubuntu file-system. You will also nee do the Github CLI tool `gh` installed. You can find instructions for how to install here: <https://cli.github.com/manual/installation>.  You will also need to be logged in with the `gh` tool, instructions for how to do that can be found here: <https://docs.github.com/en/github-cli/github-cli/quickstart>.&#x20;

### Running the script

Once these steps are complete, you can run the following commands to create a repository that holds the adapter. Note the `$` character is to show a command and not the be included in the line to execute.&#x20;

```
$ unzip Github\ Adapter.zip
```

This will extract a `script.sh` and `.env` file from the zip.

```
$ chmod +x script.sh
$ ./script.sh
```

### Running the Action

This will create a new private repository under you Github account named `my-project`, which is pre-populated with the settings to be able to run a workflow to issue a credential calling the Transmute platform API. The script will end with opening the browser to the location of this repository.&#x20;

<figure><img src="https://362859350-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCnepINstRR3UUYDZWIj%2Fuploads%2FzD8ArNpOUA79HRtI7xph%2Fimage.png?alt=media&amp;token=ff929194-5fd0-48d6-8672-506338b4fd89" alt=""><figcaption><p>Adapter repository</p></figcaption></figure>

To run the action to issue a credential, click on the `Actions` tab on the top of the repository.&#x20;

<figure><img src="https://362859350-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCnepINstRR3UUYDZWIj%2Fuploads%2FNIuEP0WKJoYJbDri9Bud%2Fimage.png?alt=media&amp;token=247fa43f-db25-4998-8c4f-d314dc93e2d0" alt=""><figcaption><p>Dispatch action </p></figcaption></figure>

On the actions page, click on the `Issue Credential` list item, then click the `Run workflow` dropdown. And click on the `Run workflow` button to trigger the action to issue the credential.

<figure><img src="https://362859350-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCnepINstRR3UUYDZWIj%2Fuploads%2FnDy141BPwlCmy9oWdGAK%2Fimage.png?alt=media&amp;token=50e98598-c14a-4ee7-8e50-52d1784b69d4" alt=""><figcaption><p>Issue credential action in progress</p></figcaption></figure>

This will initialize a new action that will have a yellow spinning icon to indicate the workflow is running. Once the action is complete you should see the spinning yellow icon turn into a green check-mark.&#x20;

<figure><img src="https://362859350-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCnepINstRR3UUYDZWIj%2Fuploads%2FaiQLsyGn0HdUEjIE174v%2Fimage.png?alt=media&amp;token=4d9e6154-2887-46b4-b8bc-6a71f1342de8" alt=""><figcaption><p>Issue credential action complete</p></figcaption></figure>

Click on the `Issue Credential` text to see the details about the action that was run.&#x20;

<figure><img src="https://362859350-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCnepINstRR3UUYDZWIj%2Fuploads%2FshZ1l9EUBpOYpvW7JRGk%2Fimage.png?alt=media&amp;token=8c34a886-7444-46e7-994b-659a09cef03b" alt=""><figcaption><p>Issue Credential artifact</p></figcaption></figure>

You can click on the `issued-verifiable-credential` artifact in order to download the credential that you issued. And example of what this should look like is displayed below.

```json
{
  "@context": "https://www.w3.org/2018/credentials/v1",
  "type": [
    "VerifiableCredential"
  ],
  "issuer": "did:web:test.transmute.industries:organizations:org_pmybE9LVkDde9Jh7",
  "issuanceDate": "2023-01-10T14:49:39Z",
  "credentialSubject": {
    "id": "did:example:456"
  },
  "proof": {
    "type": "Ed25519Signature2018",
    "created": "2023-01-10T14:49:40Z",
    "verificationMethod": "did:web:test.transmute.industries:organizations:org_pmybE9LVkDde9Jh7#z6MkfJwuJniojSD6XmeQ3V9xkkaw6EZp53BnnMMUrQNxAGRM",
    "proofPurpose": "assertionMethod",
    "jws": "eyJhbGciOiJFZERTQSIsImI2NCI6ZmFsc2UsImNyaXQiOlsiYjY0Il19..IOyALSto5FQwa8HUxM2e8dYrT8rQG__v0rT4hxCnPTaXMRSFL8DGWbo0q3kcemP20US9e4V80zlXqsttl9ezBg"
  }
}
```

If you want to verify that your credential was issued, you can navigate to your list of credentials in the application to see the credential populated there.

### Credential Issued

<figure><img src="https://362859350-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCnepINstRR3UUYDZWIj%2Fuploads%2FH3cD96QUsYKs1kz7DHb7%2Fimage.png?alt=media&amp;token=e83beae6-1e9a-434a-a61e-db3de2d68d81" alt=""><figcaption><p>Issued credential in application</p></figcaption></figure>

Congratulations on issuing your first credential with a workflow. See what other functionality we can help you unlock with GitHub workflows.&#x20;