Skip to content

Latest commit

Β 

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ€– AI Code Reviewer

πŸ”₯ Build a complete AI-Powered Code Reviewer using Python, Gemini API, Static Analysis, Radon & Streamlit in just one project!

πŸ“Œ Part of: Super Sunday Project Series πŸš€

  • πŸ‘‰ New AI/ML project every Sunday
  • πŸ‘‰ Learn by building real-world applications
  • πŸ‘‰ Beginner Friendly + Industry Level Concepts

[Watch Full Video](https://youtu.be/YOUR_VIDEO_LINK)


⭐ Support & Follow

If this project helps you:

  • ⭐ Star this repository
  • πŸ‘¨β€πŸ’» Follow me on GitHub for more AI projects
  • πŸ“Ί Subscribe to my YouTube Channel
  • πŸš€ Share this project with your friends

πŸŽ₯ Project Overview

An intelligent AI Code Reviewer built using Python, Gemini API, Static Analysis, Radon & Streamlit.

Instead of simply checking whether your code runs, this application performs a detailed review of your Python code by combining traditional code analysis techniques with the power of Google's Gemini AI.

The system helps developers and students:

βœ… Detect syntax errors
βœ… Analyze code complexity
βœ… Measure maintainability
βœ… Perform static code analysis
βœ… Generate AI-powered code reviews
βœ… Suggest best coding practices
βœ… Improve code readability and quality


✨ Features

πŸ€– AI Code Review

  • Gemini API integration
  • Intelligent code analysis
  • AI-generated suggestions
  • Code optimization recommendations

πŸ›‘οΈ Syntax Checker

  • Detect syntax errors instantly
  • Highlight invalid Python code
  • Beginner-friendly error messages

πŸ“Š Code Complexity Analysis

  • Cyclomatic Complexity
  • Maintainability Index
  • Complexity grading
  • Function-wise analysis

πŸ” Static Code Analysis

  • Detect unused variables
  • Find potential issues
  • Analyze function structure
  • Improve code quality

πŸ’‘ AI Suggestions

  • Performance improvements
  • Readability enhancements
  • Best coding practices
  • Clean code recommendations

⚑ Streamlit Dashboard

  • Modern UI
  • Interactive code editor
  • Instant analysis
  • Beautiful report generation

πŸ“Έ Application Preview

🏠 Home Dashboard

Screenshot 2026-07-24 131654

✍️ Improvements

Screenshot 2026-07-24 132141

πŸ“Š Complexity Analysis

Screenshot 2026-07-24 132159 Screenshot 2026-07-24 132302

πŸ€– AI Review Report

Screenshot 2026-07-24 132320 Screenshot 2026-07-24 132333

πŸš€ Getting Started

πŸ“Œ Prerequisites

Before running this project, install:

  • Python 3.10+
  • pip
  • Gemini API Key

βš™οΈ Installation

1️⃣ Clone Repository

git clone https://github.com/YOUR_USERNAME/AI-Code-Reviewer.git

2️⃣ Move to Project Folder

cd AI-Code-Reviewer

3️⃣ Install Required Libraries

pip install -r requirements.txt

4️⃣ Configure Gemini API

Create a .env file inside the project directory.

GEMINI_API_KEY=YOUR_API_KEY

5️⃣ Run the Application

streamlit run app.py

🧠 AI Workflow

Step 1

User writes or pastes Python code.

⬇️

Step 2

Syntax Checker validates the code.

⬇️

Step 3

Static Analyzer examines the program structure.

⬇️

Step 4

Radon calculates:

  • Cyclomatic Complexity
  • Maintainability Index

⬇️

Step 5

Gemini API reviews the complete code.

⬇️

Step 6

Final AI Review Report is generated.


πŸ“Š Analysis Features

βœ… Syntax Validation

βœ… Static Code Analysis

βœ… Cyclomatic Complexity

βœ… Maintainability Index

βœ… AI-Based Code Review

βœ… Performance Suggestions

βœ… Best Practice Recommendations

βœ… Clean Code Guidance


πŸ› οΈ Technologies Used

Technology Purpose
Python Core Programming
Streamlit Web Application
Gemini API AI Code Review
Radon Complexity Analysis
AST Static Code Analysis
Streamlit Ace Code Editor
Google GenAI SDK Gemini Integration

πŸ“‚ Project Structure

AI-Code-Reviewer/
β”‚
β”œβ”€β”€ app.py
β”œβ”€β”€ reviewer.py
β”œβ”€β”€ complexity.py
β”œβ”€β”€ static_analysis.py
β”œβ”€β”€ syntax_checker.py
β”œβ”€β”€ utils.py
β”œβ”€β”€ test.py
β”œβ”€β”€ requirements.txt
β”œβ”€β”€ README.md
└── .gitignore

πŸ“ˆ Code Quality Metrics

The application evaluates:

  • Cyclomatic Complexity
  • Maintainability Index
  • Syntax Validation
  • Static Analysis
  • Code Readability
  • AI Quality Score
  • Performance Suggestions

🎯 Learning Outcomes

By building this project, you will learn:

βœ… Streamlit Dashboard Development

βœ… Gemini API Integration

βœ… Prompt Engineering

βœ… Static Code Analysis using AST

βœ… Cyclomatic Complexity

βœ… Maintainability Index

βœ… Code Quality Analysis

βœ… Python Project Structure

βœ… Environment Variables (.env)

βœ… AI Application Development


🌟 Future Improvements

  • Multi-language support
  • GitHub Repository Review
  • PDF Review Report
  • Code Security Analysis
  • AI Bug Detection
  • Code Refactoring Suggestions
  • Docker Support
  • Authentication System
  • Team Collaboration
  • Cloud Deployment

☁️ Deployment

Deploy this application using:

  • Streamlit Community Cloud
  • Render
  • Railway
  • Hugging Face Spaces
  • Azure App Service
  • AWS EC2

🀝 Contributing

Contributions are always welcome!

If you'd like to improve this project:

  1. Fork this repository
  2. Create a feature branch
  3. Commit your changes
  4. Push to GitHub
  5. Open a Pull Request

πŸ“œ License

This project is licensed under the MIT License.


πŸ‘¨β€πŸ’» Developed By

Mahesh Verma

πŸš€ AI/ML Educator | Full Stack Developer | Content Creator

πŸ“Ί YouTube: Study Trigger

πŸ“Έ Instagram: https://www.instagram.com/studytrigger/

πŸ”— LinkedIn: https://www.linkedin.com/in/studytrigger/

πŸ’» GitHub: https://github.com/YOUR_USERNAME


⭐ If You Like This Project

Please support by:

⭐ Starring this repository

🍴 Forking the project

πŸ“Ί Subscribing to Study Trigger

🀝 Sharing with your friends

πŸ’¬ Giving your valuable feedback


πŸ”₯ Super Sunday Project Series

πŸš€ Every Sunday = One New Real-World AI/ML Project

Recent Projects:

  • πŸ“Š Student Result Analysis System
  • πŸ’° Smart Expense Tracker
  • 🧹 Data Cleaning Tool
  • πŸ€– AI Interview Preparation System
  • πŸ›’ Smart Shopping Decision Assistant
  • πŸ“ˆ Sales Prediction System
  • πŸ€– AI Code Reviewer

Stay Connected ❀️

Happy Coding! πŸš€

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages