Contributing

Thanks for your interest in contributing to OpenHands! We welcome and appreciate contributions.

How Can I Contribute?

There are many ways that you can contribute:

Download and use OpenHands, and send issues when you encounter something that isn't working or a feature that you'd like to see.
Send feedback after each session by clicking the thumbs-up thumbs-down buttons, so we can see where things are working and failing, and also build an open dataset for training code agents.
Improve the Codebase by sending PRs (see details below). In particular, we have some good first issue issues that may be ones to start on.

Understanding OpenHands's CodeBase

To understand the codebase, please refer to the README in each module:

When you write code, it is also good to write tests. Please navigate to the tests folder to see existing test suites. At the moment, we have two kinds of tests: unit and integration. Please refer to the README for each test suite. These tests also run on GitHub's continuous integration to ensure quality of the project.

Sending Pull Requests to OpenHands

1. Fork the Official Repository

Fork the OpenHands repository into your own account. Clone your own forked repository into your local environment:

git clone git@github.com:<YOUR-USERNAME>/OpenHands.git

2. Configure Git

Set the official repository as your upstream to synchronize with the latest update in the official repository. Add the original repository as upstream:

cd OpenHands
git remote add upstream git@github.com:All-Hands-AI/OpenHands.git

Verify that the remote is set:

git remote -v

You should see both origin and upstream in the output.

3. Synchronize with Official Repository

Synchronize latest commit with official repository before coding:

git fetch upstream
git checkout main
git merge upstream/main
git push origin main

4. Set up the Development Environment

We have a separate doc Development.md that tells you how to set up a development workflow.

5. Write Code and Commit It

Once you have done this, you can write code, test it, and commit it to a branch (replace my_branch with an appropriate name):

git checkout -b my_branch
git add .
git commit
git push origin my_branch

6. Open a Pull Request

On GitHub, go to the page of your forked repository, and create a Pull Request:
- Click on Branches
- Click on the ... beside your branch and click on New pull request
- Set base repository to All-Hands-AI/OpenHands
- Set base to main
- Click Create pull request

The PR should appear in OpenHands PRs.

Then the OpenHands team will review your code.

PR Rules

1. Pull Request title

As described here, a valid PR title should begin with one of the following prefixes:

feat: A new feature
fix: A bug fix
docs: Documentation only changes
style: Changes that do not affect the meaning of the code (white space, formatting, missing semicolons, etc.)
refactor: A code change that neither fixes a bug nor adds a feature
perf: A code change that improves performance
test: Adding missing tests or correcting existing tests
build: Changes that affect the build system or external dependencies (example scopes: gulp, broccoli, npm)
ci: Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs)
chore: Other changes that don't modify src or test files
revert: Reverts a previous commit

For example, a PR title could be:

refactor: modify package path
feat(frontend): xxxx, where (frontend) means that this PR mainly focuses on the frontend component.

You may also check out previous PRs in the PR list.

2. Pull Request description

If your PR is small (such as a typo fix), you can go brief.
If it contains a lot of changes, it's better to write more details.

CONTRIBUTING.md 4.6 KB Riwayat Mentahan