The-PR-Agent /pr-agent

🚀 PR Agent: The Original Open-Source PR Reviewer. This project is not the Qodo free tier.

★ 16,225⑂ 2,207👁 64⑃ 3,536● 1,359▤ 42
PythonMITCreated 2023-07-05www.pr-agent.ai
下载:v0.50.0v0.50.0 ↓0.50.02026-11-07
+59
日增长
16,225
stars
2,207
forks
64
watchers
3,536
prs
1,359
issues
42
releases

README

The Original Open-Source PR Reviewer



























---

 This repository contains the open-source PR Agent Project.
 It is not the Qodo offering for open-source projects.

PR-Agent is an open-source, AI-powered code review agent and a community-maintained legacy project of Qodo. It is distinct from Qodo's primary AI code review offering, which provides a feature-rich, context-aware experience. Qodo offers a free version for open-source projects and integrates seamlessly with GitHub, GitLab, Bitbucket, and Azure DevOps for high-quality automated reviews.


 Sponsors

PR-Agent is a community-maintained open-source project, with its ongoing development supported by our sponsors. If you'd like to support the project, consider becoming a sponsor.


  🥇 Gold Sponsor



  
    
  



  Free version of Qodo for open-source projects



 Table of Contents

- Getting Started
- Why Use PR-Agent?
- Features
- See It in Action
- How It Works
- Data Privacy
- Contributing

 Getting Started

 [!NOTE]
 Docker Hub namespace migration. Releases 0.34.2 and later are published under pragent/pr-agent. Older releases (up to and including v0.31) remain available at the legacy codiumai/pr-agent namespace as a frozen archive — no new images are pushed there. Update any pinned image: / docker pull / uses: docker:// references when upgrading to 0.34.2+.

 🚀 Quick Start for PR-Agent

 1. GitHub Action (Recommended)

Add automated PR reviews to your repository with a simple workflow file:

yaml
 .github/workflows/pr-agent.yml
name: PR Agent
on:
  pull_request:
     PR-Agent skips synchronize by default. Include it in github_action_config.pr_actions
     for auto commands, or enable github_action_config.handle_push_trigger for push_commands (takes precedence).
    types: [opened, synchronize]
jobs:
  pr_agent_job:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      issues: write
      pull-requests: write
    steps:
    - name: PR Agent action step
      uses: the-pr-agent/pr-agent@main
      env:
        OPENAI_KEY: ${{ secrets.OPENAI_KEY }}
        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Full GitHub Action setup guide

 2. CLI Usage (Local Development)

Run PR-Agent locally on your repository:

bash
pip install "pr-agent[github]"
export OPENAI__KEY=your_openai_key
export GITHUB__USER_TOKEN=your_github_token
pr-agent --pr_url https://github.com/owner/repo/pull/123 review

Git provider SDKs are optional extras: install the one for your provider (list), or pr-agent[all] for every integration.
Complete CLI setup guide

 3. Other Platforms

- GitLab webhook setup
- BitBucket app installation
- Azure DevOps setup

 News and Updates

Full notes for every release are on the Releases page.


 Why Use PR-Agent?

 🎯 Built for Real Development Teams

Fast & Affordable: Each command (/review, /ask) uses a single LLM call (~30 seconds, low cost)

Handles Any PR Size: Our PR Compression strategy effectively processes both small and large PRs

Highly Custo

Top issues

Discussions

Latest release

v0.50.0 v0.50.0 2026-11-07
⚠️ Breaking changes and upgrade notes

- Host-only settings: Repository .pr_agent.toml files can no longer override GitHub pacing and retry settings (github.seconds_between_requests, github.seconds_between_writes, github.api_retries, github.ratelimit_retries), config.num_retries, azure_devops_server.agent_identity, custom-label settings (config.enable_custom_labels and [custom_labels]), or pr_code_suggestions.max_number_of_calls. config.num_retries is capped at 10. Per-directory .pr_agent.toml files also cannot set pr_code_suggestions.dual_publishing_score_threshold. Move values you rely on 

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON