A multi-platform PR review agent using Google ADK and Gemini 2.5 Flash to automatically review pull requests and merge requests.

Supports both GitHub and GitLab through a platform-agnostic architecture.

1. Python 3.11+ with virtual environment
2. Git hosting CLI (choose based on your platform):
   • GitHub CLI (gh) - Install from https://cli.github.com/
   • brew install gh
   • GitLab CLI (glab) - Install from https://gitlab.com/gitlab-org/cli
   • brew install glab
3. Google Cloud SDK - For Vertex AI authentication
4. Git platform authentication:
   • GitHub: Run gh auth login
   • GitLab: Run glab auth login

# Clone the repository
git clone https://github.com/darkin100/i-am-reviewed.git
cd i-am-reviewed

#create virtual env

python3 -m venv .venv

# Activate virtual environment
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt
pip install -e .               

1. Copy the example environment file:

   cp src/.env.example src/.env

2. Edit src/.env with your settings:

   For GitHub:

   # Google Cloud / Vertex AI
   GOOGLE_CLOUD_PROJECT=your-project-id
   GOOGLE_CLOUD_LOCATION=europe-west2  # or your preferred region
   
   # GitHub - Update for the PR you want to review
   REPOSITORY=owner/repo               # e.g., "darkin100/i-am-reviewed"
   PR_NUMBER=1                         # PR number to review
   GH_TOKEN=ghp_xxxxxxxxxxxx           # GitHub Personal Access Token

   For GitLab:

   # Google Cloud / Vertex AI
   GOOGLE_CLOUD_PROJECT=your-project-id
   GOOGLE_CLOUD_LOCATION=europe-west2  # or your preferred region
   
   # GitLab - Update for the MR you want to review
   REPOSITORY=group/project            # e.g., "mygroup/myproject"
   PR_NUMBER=1                         # MR IID to review
   GITLAB_TOKEN=glpat-xxxxxxxxxxxx     # GitLab Personal Access Token
   CI_SERVER_HOST=gitlab.com           # Optional: custom GitLab instance

3. Authenticate with Google Cloud:

   gcloud auth application-default login

4. Set authentication tokens:

   • GitHub: Set GH_TOKEN in .env with a Personal Access Token (PAT) with repo scope
   • GitLab: Set GITLAB_TOKEN in .env with a Personal Access Token (PAT) with api scope

   Note: In CI/CD environments, these tokens are typically provided automatically (GITHUB_TOKEN in GitHub Actions, CI_JOB_TOKEN in GitLab CI).

# Make sure you're in the project root and venv is activated
source venv/bin/activate

# Run for GitHub
python -m workflow --provider github

# Or run for GitLab
python -m workflow --provider gitlab

For GitHub:

1. Find a public PR to test with (or create one in your own repo)
2. Update .env with the repository, PR number, and token:

   REPOSITORY=facebook/react
   PR_NUMBER=28099
   GH_TOKEN=ghp_your_token_here

3. Run the agent:

   python -m workflow --provider github

4. Check the PR for the review comment

For GitLab:

1. Find a public MR to test with (or create one in your own project)
2. Update .env with the project path, MR IID, and token:

   REPOSITORY=gitlab-org/gitlab
   PR_NUMBER=100
   GITLAB_TOKEN=glpat_your_token_here

3. Run the agent:

   python -m workflow --provider gitlab

4. Check the MR for the review comment

Starting review for PR #123 in owner/repo...
Fetching PR metadata...
Fetching PR diff...
Generating review with AI agent...
Posting review comment to PR...
✓ Review successfully posted to PR #123
View at: https://github.com/owner/repo/pull/123

The main agent located in src/workflow.py is designed for CI/CD integration and automated reviews. It:

• Reads PR details from environment variables (REPOSITORY, PR_NUMBER)
• Fetches PR metadata and diff using platform CLI tools
• Generates a comprehensive code review using Gemini 2.5 Flash
• Posts the review as a comment directly to the PR/MR
• Includes full tracing and observability via Cloud Trace

This is the workflow used in GitHub Actions and GitLab CI pipelines.

The ADK web interface (src/adk_agents/pr_review/agent.py) is a read-only testing environment for:

• Testing and iterating on the system prompt
• Validating tool functionality (get_pr_info, get_pr_diff)
• Interactive exploration of PR content
• Development and debugging without affecting real PRs

Key difference: The Dev UI does not have access to the post_pr_comment tool, so reviews are only displayed in the chat interface and never posted to GitHub/GitLab.

Use the ADK Dev UI for testing the agent's system prompt and reviewing PRs interactively without posting comments.

1. Ensure environment variables are configured in src/.env:

   GOOGLE_CLOUD_PROJECT=your-project-id
   GOOGLE_CLOUD_LOCATION=europe-west2
   # Plus GH_TOKEN or GITLAB_TOKEN as needed

2. Authenticate with required services:

   gcloud auth application-default login
   gh auth login   # For GitHub PRs
   glab auth login # For GitLab MRs

3. Start the ADK web server:

   source venv/bin/activate
   adk web src/adk_agents

4. Open the UI in your browser at http://localhost:8000

In the web interface, you can ask the agent to review PRs using natural language:

By URL:

Review https://github.com/owner/repo/pull/123

By repository and number:

Review PR #42 in owner/repo on GitHub

For GitLab:

Review MR !15 in mygroup/myproject on GitLab

Note: The post_pr_comment tool is intentionally excluded from the Dev UI to prevent accidental posts during testing.

force build