🚀 RepoSage — AI-Powered Developer Copilot

• ✨ Features
• 🏗️ Architecture
• 🛠️ Tech Stack
• ⚡ Quick Start
• 🤖 GitHub Action Integration
• 📊 API Reference
• 🗺️ Roadmap
• 🤝 Contributing
• 👥 Contributors
• 📜 License

graph TB
    subgraph Frontend["🎨 Frontend (React + Vite)"]
        UI[Dashboard UI]
        Theme[Theme Toggle]
        FileNav[File Navigator]
        Metrics[Metrics Panel]
    end

    subgraph Backend["⚙️ Backend (Node.js + Express)"]
        API[REST API]
        Clone[Repo Cloner]
        Scanner[Security Scanner]
        Analyzer[Complexity Analyzer]
        Reporter[Report Exporter]
    end

    subgraph AIEngine["🧠 AI Engine (Python + FastAPI)"]
        LLM[LLM Integration]
        Prompt[Prompt Manager]
        Models[Llama · DeepSeek · Gemma]
    end

    subgraph GitHubAction["🤖 GitHub Action"]
        Webhook[PR Webhook]
        Reviewer[Inline Reviewer]
    end

    UI --> API
    API --> Clone
    Clone --> Scanner
    Clone --> Analyzer
    API --> LLM
    LLM --> Prompt
    Prompt --> Models
    API --> Reporter
    Webhook --> Reviewer
    Reviewer --> API

The project is split into four independent modules:

Layer	Technologies
Frontend
Backend
AI Engine
AI Models
DevOps

• Node.js ≥ 18 & npm ≥ 9
• Python ≥ 3.10 & pip
• Git
• A free Groq API Key

git clone https://github.com/kalyan-1845/ai-code-reviewer.git
cd ai-code-reviewer

cd backend
npm install
cp .env.example .env    # Add your GROQ_API_KEY
npm run dev              # Starts on http://localhost:5000

cd ai-engine
pip install -r requirements.txt
uvicorn app:app --reload  # Starts on http://localhost:8000

cd frontend
npm install
npm run dev              # Starts on http://localhost:3000

💡 Tip: Open http://localhost:3000 in your browser, paste any public GitHub repo URL, and click Analyze to see RepoSage in action!

Add automated AI code review to any repository in 2 minutes:

# .github/workflows/reposage-review.yml
name: RepoSage AI Reviewer
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      pull-requests: write
    steps:
      - name: Checkout Code
        uses: actions/checkout@v4
      - name: Run RepoSage AI PR Audit
        uses: kalyan-1845/ai-code-reviewer/github-action@main
        with:
          github-token: ${{ secrets.GITHUB_TOKEN }}
          groq-api-key: ${{ secrets.GROQ_API_KEY }}

The bot will automatically post inline, line-by-line review comments on every new PR!

For complete endpoint documentation with request/response examples, see API.md.

See our full ROADMAP.md for the detailed project roadmap.

We are proudly part of GirlScript Summer of Code (GSSoC) '26! 🎉

We welcome contributions from everyone — whether you're a first-time open-source contributor or a seasoned developer.

1. 📖 Read our Contributing Guidelines
2. 🏷️ Browse Good First Issues for beginner-friendly tasks
3. 💬 Comment on an issue to get assigned
4. 🍴 Fork, code, and submit a PR!

Note: Please wait for an admin/mentor to assign the issue before starting work to avoid duplicate efforts.

Thanks to all the amazing people who have contributed to RepoSage! 💙

If you find RepoSage useful, please consider giving it a ⭐ on GitHub — it helps the project grow and motivates us to keep improving!

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