Skip to main content

PR-Arena: Arena Setting for GitHub Issue Resolver

Project description

⚔️ OpenHands PR Arena ⚔️

👐 We welcome your feedback. Feel free to fill out the google form, send an email, or open an issue on this repository. 👐

OpenHands PR Arena is a platform for evaluating and benchmarking agentic coding assistants through paired pull request (PR) generations. PR Arena enables developers to compare multiple LLMs in real-world issue resolution by presenting side-by-side pull requests and allowing users to select the better fix.

Follow the instruction below to setup the Arena setting for the OpenHands resolver.

Demo

Maintainer

X (formerly Twitter) Follow GitHub Website

How to Get Started with the OpenHands PR Arena GitHub App

How to use

  1. Install OpenHands PR Arena to your GitHub Repository
    • Go to the installation page
    • Under Repository access, select the repositories you want to install the app on

Once you've installed the GitHub App ...

🎉 You’re all set. Let’s start fixing your GitHub issues!

  1. Open the repository where the GitHub App was installed (i.e., where you’d like to resolve issues).
  2. Label an issue with pr-arena to trigger the automated fix:
    • Open or create an issue, click Labels in the sidebar, and select pr-arena
  3. Wait for the agent to resolve the issue and open the Arena (this may take 10-20 minutes)
  4. Click the link in the comment to enter the Arena and choose your preferred model
  5. The selected fix will be automatically submitted as a Pull Request

⭐️ Please watch the guideline video that explains how to use the OpenHands PR Arena GitHub App!

Arena Lifecycle

  • Progress is continuously updated via comments on the issue — keep an eye on them!
  • The Arena will automatically close 60 minutes after the label is applied, but you can still view fixes and vote.
  • For guidance on locally testing proposed fixes and viewing Arena results after closure, see ARENA_GUIDE.md.

Privacy Notification

  1. The only code we collect is the git_diff generated during issue resolution. We never access or store the entire codebase, access GitHub secrets, or release any user data.
  2. Important: Installing this App will automatically add a workflow file named pr-arena-workflow.yml to your repository. This file redirects to the actual resolver workflow located here. If you are concerned about repository workflows, we encourage you to review the resolver workflow to understand the operations it performs.
  3. Do not modify the injected workflow. Any modifications will prevent it from being triggered.
  4. Please install and use this app only on repositories where you consent to having code snippets (i.e., git_diff) processed by the LLM provider.
  5. The following metadata is collected for research purpose:
    • User info: owner, repo, repo URL
    • Model info: user preference on model, duration of an attempt
    • Code info: agent code (git_diffs), commit hash, repository language composition

Q&A

Can I use the App in my forked repository?

✅ Yes — you can install and use OpenHands PR Arena in a forked repository. ⚠️ Note: GitHub disables Issues on forks by default. To enable them:

  1. Go to your forked repository.
  2. Navigate to Settings → General.
  3. Scroll down to Features.
  4. Check the box for Issues.

How can I track the progress?

The agent will automatically comment on the issue at each stage of the process:

  • 👐 OpenHands PR-Arena has started the task: [click here for details]. For more info about how to use OpenHands PR-Arena, [click this link].
    • Step 1. OpenHands begins resolving the issue. Please wait 10 ~ 20 minutes for the next comment.
  • ⚔️PR-Arena is now open⚔️! You can view the proposed fixes and make a decision at [this link].
    • Step 2. The Arena is open. Click the link to review both fixes and choose your preferred one.
  • PR has been created based on the fix you've selected. Please review the changes.
    • Step 3. A pull request has been created. You can now review and merge it.

What happens if an error occurs?

If an error occurs, the agent will comment on the issue with an appropriate message. You can retry by removing the pr-arena label, waiting 5 seconds, and adding it again.

How long does the process take?

The time depends on the complexity of the issue. Some models may take longer to process depending on the complexity of the task. Typically, it should take less than 30 minutes, so please be patient.

How does this affect my GitHub Actions build minutes?

The workflow makes API calls to our backend infrastructure where OpenHands agents run remotely. Your GitHub Actions runner only handles lightweight tasks like triggering the workflow and creating pull requests. The actual AI processing and code generation happens on our servers, so it consumes minimal GitHub Actions minutes (typically just a few minutes per issue).

Security & Permission

This GitHub App requires the following permissions:

  • Read & Write access to Issues and Pull Requests — to analyze issues and generate PRs
  • Workflow execution — to trigger automated fixes via GitHub Actions
  • Access to repository contents — to apply code changes and submit pull requests

No user secrets or sensitive information are stored in your repository. All sensitive operations are securely handled through our backend infrastructure.

Support and Acknowledgment

If you have any issues, please open an issue on this github repo, we're happy to help! Alternatively, you can email us or join the OpenHands Slack workspace and ask there.

This project is built upon OpenHands GitHub Backlog Resolver and inspired by Copilot Arena, an open source AI coding assistant that provides paired autocomplete completions from different LLMs.

Powered by OpenHands

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pr_arena-0.2.5.tar.gz (36.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pr_arena-0.2.5-py3-none-any.whl (38.5 kB view details)

Uploaded Python 3

File details

Details for the file pr_arena-0.2.5.tar.gz.

File metadata

  • Download URL: pr_arena-0.2.5.tar.gz
  • Upload date:
  • Size: 36.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.2.0 CPython/3.12.11 Linux/6.11.0-1018-azure

File hashes

Hashes for pr_arena-0.2.5.tar.gz
Algorithm Hash digest
SHA256 300e922d1cf33e4c80ec323e3ddadb80ddd7480ea32bd6989e3ae614a9b547ba
MD5 996c7f0b456b267e619b1ae9261597c2
BLAKE2b-256 a67d1cb0f2247c62fc0733db1ded9e92c0a2d3bff1dc34f227414988c7b8001e

See more details on using hashes here.

File details

Details for the file pr_arena-0.2.5-py3-none-any.whl.

File metadata

  • Download URL: pr_arena-0.2.5-py3-none-any.whl
  • Upload date:
  • Size: 38.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.2.0 CPython/3.12.11 Linux/6.11.0-1018-azure

File hashes

Hashes for pr_arena-0.2.5-py3-none-any.whl
Algorithm Hash digest
SHA256 68e51d30260585e344a81f57bbdf5d235c8c208078a8c09ecc0f1fdd136ff9ff
MD5 5b1ceea79748fef6f97881440fa3a73f
BLAKE2b-256 19b2a1fce61e65ec9f0b8b3f737feefdc2ad9f31cc70b88ba1c3a3f6141d1610

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page