ThomasLe/code-grader-agent

🤖 Code-Grader-Agent

An AI-powered code review and grading system that analyzes GitHub repositories using advanced language models.

✨ Features

• —🔍 Repository Analysis: Clone and analyze any public GitHub repository
• —📊 Multi-Criteria Grading: Evaluate code against custom criteria
• —🎯 Project Structure Assessment: Analyze folder organization and architecture
• —📝 Detailed Reports: Get comprehensive feedback on code quality
• —⚡ Fast Processing: Powered by Gemini Flash 1.5 for quick analysis

🚀 How to Use

1. 1.Enter Repository URL: Paste any public GitHub repository URL
2. 2.Select File Extensions: Choose which file types to analyze
3. 3.Generate Project Description: AI analyzes the codebase structure
4. 4.Set Grading Criteria: Define what aspects to evaluate
5. 5.Select Files: Choose specific files or folders to grade
6. 6.Run Analysis: Get detailed feedback and scores

🔧 Configuration

You'll need to set your OpenRouter API key in the environment variables to use this application.

🛠️ Tech Stack

• —Frontend: React + TypeScript + Ant Design
• —Backend: FastAPI + LangChain
• —AI Model: Gemini Flash 1.5 via OpenRouter
• —Deployment: Docker on Hugging Face Spaces

📊 Example Use Cases

• —Code Reviews: Get AI feedback on pull requests
• —Educational Assessment: Grade student programming assignments
• —Code Quality Analysis: Evaluate project structure and best practices
• —Technical Interviews: Assess coding skills objectively

🔒 Privacy

• —Repository clones are temporary and automatically cleaned up
• —No code or data is stored permanently
• —API keys are handled securely through environment variables