站内导读
定位:PR-Agent 是开源的 AI 代码评审 Agent,由社区维护,属于 Qodo 的 legacy 项目,用于在 PR 流程中自动给出评审意见。
核心能力
- 以 GitHub Action 方式接入,在 pull_request 的 opened、synchronize 事件上触发评审任务。
- 提供官方 Docker 镜像,0.34.2 及之后的版本发布在 pragent/pr-agent 命名空间下。
- 与 Qodo 主推的商业版评审产品相互独立,本仓库由社区维护,能力边界以 README 为准。
- README 单列 Data Privacy 章节,部署前可据此核对数据处理方式。
适用人群:适合已有 GitHub 仓库、希望在现有 PR 流程中加入自动评审的团队;需要能运行 GitHub Actions 或拉取 Docker 镜像的环境。
注意:镜像自 0.34.2 起发布在 pragent/pr-agent 命名空间下。
位置づけ:PR-Agent はオープンソースの AI コードレビュー Agent で、コミュニティが保守する Qodo のレガシープロジェクトです。PR の流れの中で自動的にレビュー意見を提示します。
主な機能
- GitHub Action として導入でき、pull_request の opened・synchronize イベントでレビュー処理が起動します
- 公式 Docker イメージが提供され、0.34.2 以降のリリースは pragent/pr-agent 名前空間で公開されています
- Qodo が主力とする商用レビュー製品とは独立しており、本リポジトリはコミュニティが保守します。能力の範囲は README が基準です
- README には Data Privacy の章が独立して設けられており、導入前にデータの扱いを確認できます
対象ユーザー:GitHub リポジトリをすでに持ち、既存の PR フローに自動レビューを加えたいチームに。GitHub Actions を実行できる、または Docker イメージを取得できる環境が必要です。
정의: PR-Agent는 오픈소스 AI 코드 리뷰 Agent로, 커뮤니티가 유지하는 Qodo의 레거시 프로젝트입니다. PR 과정 안에서 자동으로 리뷰 의견을 제시합니다.
핵심 기능
- GitHub Action 방식으로 연결되며, pull_request의 opened, synchronize 이벤트에서 리뷰 작업이 실행됩니다
- 공식 Docker 이미지를 제공하며, 0.34.2 이후 버전은 pragent/pr-agent 네임스페이스에 공개되어 있습니다
- Qodo가 주력하는 상용 리뷰 제품과는 독립적이며, 이 저장소는 커뮤니티가 유지합니다. 기능 범위는 README를 기준으로 합니다
- README에 Data Privacy 항목이 따로 마련되어 있어 배포 전에 데이터 처리 방식을 확인할 수 있습니다
대상 사용자: 이미 GitHub 저장소가 있고 기존 PR 흐름에 자동 리뷰를 더하려는 팀에게 적합합니다. GitHub Actions를 실행하거나 Docker 이미지를 받아올 수 있는 환경이 필요합니다.
What it is: PR-Agent is an open-source, AI-powered code review agent maintained by the community as a legacy Qodo project, and it reviews pull requests automatically.
Key capabilities
- Runs as a GitHub Action triggered by pull_request opened and synchronize events through a workflow file.
- Publishes Docker images; releases 0.34.2 and later live under the pragent/pr-agent namespace.
- Stays separate from Qodo's primary AI review product, which is the commercial offering with broader context handling.
- Keeps a dedicated Data Privacy section in the README for teams assessing deployment.
README · 详细文档
来源 · 查看原文
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. Releases0.34.2and later are published under 1. Older releases (up to and includingv0.31) remain available at the legacy 3 namespace as a frozen archive — no new images are pushed there. Update any pinnedimage:/docker pull/uses: docker://references when upgrading to0.34.2+.
🚀 Quick Start for PR-Agent
1. GitHub Action (Recommended)
Add automated PR reviews to your repository with a simple workflow file:
# .github/workflows/pr-agent.yml
name: PR Agent
on:
pull_request:
types: [opened, synchronize]
jobs:
pr_agent_job:
runs-on: ubuntu-latest
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:
pip install "pr-agent[github]"
export OPENAI_KEY=your_key_here
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
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 tool (/review, /improve, /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 Customizable: JSON-based prompting allows easy customization of review categories and behavior via configuration files
Platform Agnostic:
- Git Providers: GitHub, GitLab, BitBucket, Azure DevOps, Gitea
- Deployment: CLI, GitHub Actions, Docker, self-hosted, webhooks
- AI Models: OpenAI GPT, Anthropic Claude, Google Gemini, DeepSeek, Mistral, and any other model reachable through LiteLLM (Azure OpenAI, AWS Bedrock, Vertex AI, Databricks, OpenRouter, Ollama, and more) — see Changing a model
Open Source Benefits:
- Full control over your data and infrastructure
- Customize prompts and behavior for your team's needs
- No vendor lock-in
- Community-driven development
Features
See the current feature and git provider support matrix in the PR-Agent documentation.
⚠️ /help_docs is temporarily disabled since v0.36.1 pending a fix for a credential-exposure issue (#2445).
[//]: # (- Support for additional git providers is described in [here](./docs/Fullenvironments.md)) __
See It in Action
/describe
/review
/improve
Usage Examples
PR-Agent tools run as a comment on a PR or from the CLI. A few common ones:
# Comment on a PR (GitHub/GitLab/Bitbucket/…):
/describe
/review
/improve
/ask "What does this PR change?" # free-text Q&A about the PR
# Issue-scoped commands run on an issue instead of a PR:
/similar_issue # find similar issues in the repository
# Or locally via the CLI:
pr-agent --pr_url <PR_URL> review
pr-agent --issue_url <ISSUE_URL> similar_issue
See the Tools docs for the full list of tools with example commands, and each tool's page for screenshots and options.
How It Works
The following diagram illustrates PR-Agent tools and their flow:

Data Privacy
Self-hosted PR-Agent
- If you host PR-Agent with your OpenAI API key, it is between you and OpenAI. You can read their API data privacy policy here:
https://openai.com/enterprise-privacy
Contributing
To contribute to the project, get started by reading our Contributing Guide.
For local verification, run PYTHONPATH=. uv run pytest from the repository root; it discovers the unit-test suite under tests/unittest by default. End-to-end tests under tests/e2e_tests require provider credentials and should be invoked explicitly, for example PYTHONPATH=. uv run pytest tests/e2e_tests/test_github_app.py.
Big News for PR-Agent
PR-Agent has a new home!
After years of building this tool alongside the community, Qodo has donated PR-Agent to the open-source community - and we couldn't be more excited about what comes next.
The project now lives in the PR-Agent org on GitHub, is fully community-owned, and is open for contributions and additional maintainers.
What else changed:
- Docs moved to - docs.pr-agent.ai
- Qodo Merge (Qodo 1.0), the hosted URL, which was the enterprise version of PR-Agent, has been rebranded and evolved into Qodo (Qodo 2.0), a full AI code review platform.
❤️ Community
This open-source release remains here as a community contribution from Qodo — the origin of modern AI-powered code collaboration. We’re proud to share it and inspire developers worldwide.
The project now has its first external maintainer, Naor (@naorpeled), and is currently in the process of being donated to an open-source foundation.