PR Reviewer Setup Guide

This guide provides step-by-step instructions to set up the PR Reviewer project, which includes integrations with GitHub and Notion.

Prerequisites

• curl (for MacOS/Linux)
• Python 3.x installed on your system

Setup Instructions

Step 1: Install uv

MacOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

🔁 Restart your terminal afterwards to ensure that the uv command is available.

Step 2: Create and Set Up the Project

MacOS/Linux:

# Create a new directory for the project
uv init pr_reviewer
cd pr_reviewer

# Create and activate a virtual environment
uv venv
source .venv/bin/activate

# Install core dependencies
uv add "mcp[cli]" requests python-dotenv notion-client

Step 3: Create requirements.txt and Install from It

Create a file called requirements.txt with the following content:

# Core dependencies for PR Analyzer
requests>=2.31.0          # For GitHub API calls
python-dotenv>=1.0.0      # For environment variables
mcp[cli]>=1.4.0           # For MCP server functionality
notion-client>=2.3.0      # For Notion integration

Install the packages:

uv pip install -r requirements.txt
pip install -r requirements.txt

Step 4: Set Up Environment Variables

Create a .env file in the root directory and add the following:

GITHUB_TOKEN=your_github_token
NOTION_API_KEY=your_notion_api_key
NOTION_PAGE_ID=your_notion_page_id

GitHub Token:

1. Go to GitHub → Settings → Developer Settings → Personal Access Tokens.
2. Click “Generate new token (classic)”.
3. Enable these scopes:
   • read:org
   • read:repo_hook
   • repo
4. Copy and paste the token into your .env file as GITHUB_TOKEN.

Notion Integration:

1. Go to Notion Integrations.
2. Click “New integration” and set the type to Internal.
3. Add it to your workspace.
4. Copy the Internal Integration Secret as NOTION_API_KEY.
5. Copy the UUID at the end of the integration URL as NOTION_PAGE_ID.

Step 5: Create the Main Script

Create an empty script file for your server logic:

touch pr_reviewer

Add your application logic inside this file.

Step 6: Run the Application

To run the project, make sure your environment is activated and .env is configured:

python pr_reviewer.py