🚀 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

1. Go to console.groq.com/keys and sign in (or create a free account).
2. Click Create API Key, give it a name (e.g., reposage), and copy the key.
3. The AI Engine requires the GROQ_API_KEY environment variable. It is used only by the server-side AI Engine and should not be exposed through frontend VITE_* variables. The frontend only requires VITE_API_URL to communicate with the backend API.

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

First, navigate to the frontend directory:

cd frontend

Install the dependencies:

npm install

Finally, start the development server:

npm run dev

💡 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 have recently opened 45 new granular issues across 3 massive architectural epics for our GSSoC contributors!

1. 🔌 Native VS Code Extension: Bring RepoSage directly into the developer's IDE.
2. 🧠 AI RAG System (Vector DB): Upgrade our chat feature with ChromaDB to query entire repositories using embeddings.
3. 📊 Multi-Repo Analytics Dashboard: Build an enterprise-grade tracking dashboard for engineering managers.

Want to help us build these? Jump into our Issues tab and filter by the epic or gssoc labels!

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.