GitHub Installation

​

Prerequisites

• A GitHub account
• Access to OpenHands Cloud

​

Installation Steps

1. Log in to OpenHands Cloud
2. If you haven’t connected your GitHub account yet:
   • Click on Connect to GitHub
   • Review and accept the terms of service
   • Authorize the OpenHands AI application

​

Adding Repository Access

You can grant OpenHands access to specific repositories:

1. Click on Add GitHub repos
2. Select your organization and choose the specific repositories to grant OpenHands access to.
   • OpenHands requests short-lived tokens (8-hour expiration) with these permissions:
     • Actions: Read and write
     • Administration: Read-only
     • Commit statuses: Read and write
     • Contents: Read and write
     • Issues: Read and write
     • Metadata: Read-only
     • Pull requests: Read and write
     • Webhooks: Read and write
     • Workflows: Read and write
   • Repository access for a user is granted based on:
     • Permission granted for the repository
     • User’s GitHub permissions (owner/collaborator)
3. Click Install & Authorize

​

Modifying Repository Access

You can modify repository access at any time by visiting the Settings page and selecting Configure GitHub Repositories under the Git tab.

​

Using OpenHands with GitHub

Once you’ve granted repository access, you can use OpenHands with your GitHub repositories.

For details on how to use OpenHands with GitHub issues and pull requests, see the Cloud Issue Resolver documentation.

​

Next Steps

• Access the Cloud UI to interact with the web interface
• Use the Cloud Issue Resolver to automate code fixes and get assistance
• Use the Cloud API to programmatically interact with OpenHands