🤖 Code Review Agent

An AI-powered code analysis platform that provides instant, intelligent code reviews with advanced token compression technology. Built with Next.js 16, React 19, and powered by Google's Gemini AI and ScaleDown compression.

Next.js React TypeScript Tailwind CSS License

• 🤖 AI-Powered Analysis - Advanced code review using Google Gemini 2.5 Flash
• ⚡ Smart Compression - Up to 70% token reduction with ScaleDown technology
• 🔒 Security First - Comprehensive security vulnerability detection
• 📊 Quality Scoring - Automated code quality assessment (0-100 scale)
• 🎨 Multi-Language Support - JavaScript, TypeScript, Python, Java, C++, Go, Rust
• 📈 Real-time Feedback - Instant analysis as you code
• 💰 Cost Savings - Reduced API costs through intelligent compression
• 🌓 Dark Mode - Beautiful UI with light and dark themes
• 📱 Responsive Design - Works seamlessly on desktop, tablet, and mobile

• Node.js 20.x or higher
• npm, yarn, pnpm, or bun
• Google Gemini API key (Get one here)
• ScaleDown API key - optional but recommended (Get one here)

1. Clone the repository

git clone https://github.com/pratham-prog861/code-review-agent.git
cd code-review-agent

2. Install dependencies

npm install

3. Set up environment variables

cp .env.example .env.local

Edit .env.local and add your API keys:

GEMINI_API_KEY=your_gemini_api_key_here
SCALEDOWN_API_KEY=your_scaledown_api_key_here

4. Run the development server

npm run dev

5. Open your browser

Navigate to http://localhost:3000

1. Paste your code into the editor
2. Select the programming language (JavaScript, TypeScript, Python, etc.)
3. Choose review depth:
   • Quick Scan - Fast, focuses on critical issues (5-10s)
   • Standard Review - Balanced analysis (10-20s) ⭐ Recommended
   • Deep Analysis - Comprehensive review (20-40s)
4. Toggle compression to save on API costs (recommended)
5. Click "Review Code" and get instant feedback!

// Paste this code to try it out
async function fetchUser(id) {
 const response = await fetch(`/api/users/${id}`);
 return response.json();
}

You'll receive:

• ✅ Quality score (e.g., 75/100)
• 🔴 Critical issues (security, bugs)
• ⚠️ Warnings (best practices)
• 💡 Suggestions (improvements)
• 📊 Token usage statistics

• Framework: Next.js 16 (App Router)
• UI Library: React 19
• Language: TypeScript 5
• Styling: Tailwind CSS 4
• Components: shadcn/ui (Radix UI)
• AI: Google Gemini 2.5 Flash
• Compression: ScaleDown API
• Icons: Lucide React

Comprehensive documentation is available in the docs/ folder:

• 📘 Getting Started - Detailed installation and setup
• ⚡ Features - Complete feature overview
• 🏗️ Architecture - Technical architecture and design
• 🔌 API Reference - API endpoints and usage
• ⚙️ Configuration - Environment variables and settings
• 📖 User Guide - How to use the application
• 🤝 Contributing - Guidelines for contributors
• 🔧 Troubleshooting - Common issues and solutions

• Speed: 5-10 seconds
• Focus: Critical bugs and syntax errors only
• Best For: Rapid feedback, pre-commit checks

• Speed: 10-20 seconds
• Focus: Bugs, style, best practices, performance
• Best For: Regular development workflow

• Speed: 20-40 seconds
• Focus: Architecture, security, performance, edge cases
• Best For: Production code, security audits

• ✅ Your code is never stored on our servers
• ✅ All communication is encrypted via HTTPS
• ✅ API keys are stored securely in environment variables
• ✅ No third-party tracking or analytics
• ✅ Client-side processing for maximum privacy

With ScaleDown compression enabled:

Without Compression:
 1,000 reviews/month ×ばつ 2,000 tokens = 2M tokens
 Cost: ~2ドル0/month
With Compression (70% savings):
 1,000 reviews/month ×ばつ 600 tokens = 600K tokens
 Cost: ~6ドル/month
Monthly Savings: 1ドル4 💰

Deploy with Vercel

# Install Vercel CLI
npm i -g vercel
# Deploy
vercel
# Set environment variables
vercel env add GEMINI_API_KEY
vercel env add SCALEDOWN_API_KEY

We welcome contributions! Please see our Contributing Guide for details.

# Fork and clone
git clone https://github.com/pratham-prog861/code-review-agent.git
# Install dependencies
npm install
# Create feature branch
git checkout -b feature/amazing-feature
# Make changes and commit
git commit -m "feat: add amazing feature"
# Push and create PR
git push origin feature/amazing-feature

npm run dev # Start development server
npm run build # Build for production
npm run start # Start production server
npm run lint # Run ESLint

This project is licensed under the MIT License - see the LICENSE file for details.

If you find this project helpful, please consider giving it a star on GitHub!