🤖 Code Review Bot

An AI-powered GitHub code review bot that automatically analyzes pull requests and provides intelligent feedback using Claude AI.

✨ Features

• 🔗 GitHub Integration - Installs as a GitHub App, automatically reviews PRs when opened or updated
• 🧠 AI-Powered Analysis - Uses Claude AI to provide intelligent, context-aware code reviews
• 💬 Automatic Comments - Posts review feedback directly on your pull requests
• ⚡ Background Processing - Celery workers handle analysis asynchronously for fast response times
• 📊 Dashboard - View analysis history with a clean React frontend
• 🌙 Dark Mode - Beautiful UI with smooth animations and theme switching
• 🔒 Secure - Webhook signature verification and secure token handling

🏗️ Tech Stack

Backend

Technology	Purpose
FastAPI	High-performance async Python web framework
Celery	Distributed background task processing
Redis	Task queue broker and caching
PostgreSQL	Persistent database storage
Anthropic Claude	AI-powered code analysis

Frontend

Technology	Purpose
React 18	Modern UI framework
TypeScript	Type-safe development
CSS3	Custom styling with animations

Infrastructure

Technology	Purpose
Docker	Container orchestration
ngrok	Webhook tunneling for development

📁 Project Structure

code-review-bot/
├── backend/
│   ├── app/
│   │   ├── api/routes/       # API endpoints
│   │   │   ├── webhooks.py   # GitHub webhook handler
│   │   │   └── analysis.py   # Analysis history API
│   │   ├── core/             # Business logic
│   │   │   ├── analyzer.py   # AI code analysis engine
│   │   │   ├── filters.py    # Smart file filtering
│   │   │   └── github.py     # GitHub API client
│   │   ├── db/               # Database layer
│   │   │   ├── database.py   # Async connection setup
│   │   │   └── models.py     # SQLAlchemy models
│   │   ├── tasks/            # Background tasks
│   │   │   ├── celery_app.py # Celery configuration
│   │   │   └── analysis_tasks.py
│   │   ├── config.py         # Environment settings
│   │   └── main.py           # FastAPI application
│   └── requirements.txt
├── frontend/
│   ├── src/
│   │   ├── App.tsx           # Main dashboard component
│   │   └── index.css         # Styles with dark mode support
│   └── package.json
├── docker-compose.yml        # PostgreSQL + Redis services
├── .env.example
└── README.md

🚀 Getting Started

Prerequisites

• Python 3.11+
• Node.js 20+
• Docker Desktop
• GitHub account
• Anthropic API key

1. Clone & Setup

git clone https://github.com/ke1ee/code-review-bot.git
cd code-review-bot

2. Backend Setup

# Create virtual environment
python -m venv venv

# Activate (Windows)
.\venv\Scripts\Activate

# Activate (Mac/Linux)
source venv/bin/activate

# Install dependencies
pip install -r backend/requirements.txt

3. Configure Environment

Create backend/.env:

DEBUG=true
DATABASE_URL=postgresql+asyncpg://postgres:postgres@localhost:5432/code_review_bot
REDIS_URL=redis://localhost:6379/0
CELERY_BROKER_URL=redis://localhost:6379/0
CELERY_RESULT_BACKEND=redis://localhost:6379/0

# GitHub App
GITHUB_APP_ID=your-app-id
GITHUB_WEBHOOK_SECRET=your-webhook-secret
GITHUB_APP_PRIVATE_KEY_PATH=./github-app-private-key.pem

# AI Analysis
ANTHROPIC_API_KEY=sk-ant-xxxxx
AI_PROVIDER=anthropic

4. Start Services

# Start PostgreSQL and Redis
docker-compose up -d

# Terminal 1: Start API server
cd backend
uvicorn app.main:app --reload

# Terminal 2: Start Celery worker
cd backend
celery -A app.tasks.celery_app worker --loglevel=info --pool=solo

5. Frontend Setup

cd frontend
npm install
npm start

Open http://localhost:3000 to view the dashboard.

6. GitHub App Setup

1. Go to https://github.com/settings/apps/new
2. Configure:
   • App name: your-code-review-bot
   • Homepage URL: http://localhost:8000
   • Webhook URL: Your ngrok URL + /api/webhooks/github
   • Webhook secret: Same as in your .env
3. Set permissions:
   • Contents: Read
   • Pull requests: Read & Write
   • Metadata: Read
4. Subscribe to events:
   • ☑️ Pull request
5. Generate and download a private key
6. Install the app on your repositories

7. Webhook Tunneling (Development)

ngrok http 8000

Update your GitHub App's webhook URL with the ngrok URL.

📖 API Endpoints

Method	Endpoint	Description
GET	/	API status
GET	/health	Health check with provider info
POST	/api/webhooks/github	GitHub webhook receiver
GET	/api/analysis/history/{owner}/{repo}	Get analysis history for a repo
GET	/api/analysis/detail/{id}	Get detailed analysis results

🔍 How It Works

┌─────────────────┐
│   GitHub PR     │
│    Opened       │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│    Webhook      │
│   Received      │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  Celery Task    │
│    Queued       │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  Fetch Files    │
│  from GitHub    │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  Claude AI      │
│  Analysis       │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│ Post Comments   │
│    on PR        │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│ Save to Database│
└─────────────────┘

🤖 AI Analysis Capabilities

The bot uses Claude AI to analyze code for:

• Code Quality - Identifies bugs, logic errors, and potential issues
• Best Practices - Suggests improvements based on language conventions
• Security - Flags potential security vulnerabilities
• Performance - Highlights inefficient code patterns
• Readability - Recommends clearer naming and structure
• Documentation - Suggests missing or improved comments

🎨 Dashboard Features

• Analysis History - Browse all past code reviews with status indicators
• Detailed Results - View every issue found with file paths and line numbers
• Dark Mode - Toggle between light and dark themes with smooth transitions
• Responsive Design - Works seamlessly on desktop and mobile
• Real-time Updates - See analysis results as they complete

🔧 Configuration

File Filtering

The bot automatically skips:

• Binary files (images, compiled code)
• Lock files (package-lock.json, yarn.lock)
• Generated files (pycache, node_modules)
• Configuration files (.gitignore, .env.example)

Supported Languages

• Python
• JavaScript / TypeScript
• Java
• Go
• Rust
• Ruby
• And more...

📝 License

MIT © ke1ee