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
uvcommand 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:
- Go to GitHub → Settings → Developer Settings → Personal Access Tokens.
- Click "Generate new token (classic)".
- Enable these scopes:
read:orgread:repo_hookrepo
- Copy and paste the token into your
.envfile asGITHUB_TOKEN.
Notion Integration:
- Go to Notion Integrations.
- Click "New integration" and set the type to Internal.
- Add it to your workspace.
- Copy the Internal Integration Secret as
NOTION_API_KEY. - 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