🔍 Inspectra

AI-Powered Code Review & Repository Intelligence Platform

Features • Tech Stack • Architecture • Getting Started • Documentation

📖 Overview

Inspectra is an intelligent, AI-powered code review assistant and repository management platform designed to streamline your development workflow. By leveraging advanced LLMs (Google Gemini) and RAG (Retrieval-Augmented Generation) technology with Pinecone vector database, Inspectra provides deep, context-aware insights into your code, automates reviews, and offers comprehensive analytics for your GitHub repositories.

Why Inspectra?

🤖 Context-Aware AI Reviews: Unlike generic code reviewers, Inspectra indexes your entire codebase to understand project patterns and conventions
🔗 Deep GitHub Integration: Seamless webhook-based automation for real-time PR reviews
💬 Automated PR Comments: AI-generated reviews posted directly to your Pull Requests
📊 Rich Analytics: Comprehensive dashboards with contribution graphs and activity metrics
⚡ Background Processing: Inngest-powered async jobs for reliable, scalable operations

✨ Features

🔍 AI-Powered Code Reviews

Automated review generation for Pull Requests using Google Gemini AI
RAG-based context retrieval from your indexed codebase via Pinecone
Rich feedback including walkthroughs, summaries, issue identification, and suggestions

🔗 GitHub Integration

OAuth-based authentication via GitHub
Multi-repository management with connect/disconnect workflow
Webhook automation for real-time PR handling
Direct comments and reviews posted to GitHub PRs

🧠 RAG Implementation

Automatic codebase indexing using vector embeddings
Semantic search across your entire project
Context-aware code understanding for accurate reviews

📊 Dashboard & Analytics

Real-time statistics on repositories, commits, and PRs
Interactive contribution graphs (GitHub-style activity calendar)
Monthly activity breakdowns and trend analysis

🔐 Authentication & User Management

Secure GitHub OAuth via Better Auth
Profile management and customization
Session handling with automatic token refresh

⚙️ Background Processing

Inngest-powered async job processing
Repository indexing workflows
Reliable webhook event handling

🛠️ Tech Stack

Frontend

Technology	Purpose
Next.js 16	React framework with App Router
React 19	UI library with latest features
TypeScript	Type-safe development
Tailwind CSS 4	Utility-first styling
shadcn/ui	Pre-built accessible components
Radix UI	Headless UI primitives
TanStack Query	Server state management
Recharts	Data visualization
Framer Motion	Animations

Backend

Technology	Purpose
Next.js API Routes	RESTful API endpoints
Server Actions	Type-safe server mutations
Prisma ORM	Database access layer
PostgreSQL	Primary database
Pinecone	Vector database for RAG
Inngest	Background job processing
Better Auth	Authentication system

AI & Machine Learning

Technology	Purpose
OpenRouter	AI model gateway
Qwen3 Coder	LLM for code analysis
Google Gemini	Embedding generation
Vercel AI SDK	AI integration framework
Pinecone	Vector similarity search

Integrations

Technology	Purpose
Octokit	GitHub API client
GitHub Webhooks	Real-time event handling
Zod	Schema validation
React Hook Form	Form handling

🏗️ Architecture

System Overview

┌─────────────────────────────────────────────────────────────────────────┐
│                              USER BROWSER                                │
│                                                                         │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  ┌─────────────┐ │
│  │   Landing    │  │  Dashboard   │  │ Repository   │  │  Settings   │ │
│  │    Page      │  │    Page      │  │    Page      │  │    Page     │ │
│  └──────────────┘  └──────────────┘  └──────────────┘  └─────────────┘ │
└─────────────────────────────────────────────────────────────────────────┘
                                    │
                                    ▼
┌─────────────────────────────────────────────────────────────────────────┐
│                           NEXT.JS APP ROUTER                             │
│                                                                         │
│  ┌────────────────────────────────────────────────────────────────────┐ │
│  │                        API ROUTES                                   │ │
│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐               │ │
│  │  │ /api/auth   │  │/api/webhooks│  │ /api/inngest│               │ │
│  │  │ (Better Auth│  │  (GitHub)   │  │  (Jobs)     │               │ │
│  │  └─────────────┘  └─────────────┘  └─────────────┘               │ │
│  └────────────────────────────────────────────────────────────────────┘ │
│                                                                         │
│  ┌────────────────────────────────────────────────────────────────────┐ │
│  │                      SERVER ACTIONS                                │ │
│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐               │ │
│  │  │ Repository  │  │  Settings   │  │  Dashboard  │               │ │
│  │  │  Actions    │  │  Actions    │  │  Actions    │               │ │
│  │  └─────────────┘  └─────────────┘  └─────────────┘               │ │
│  └────────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────┘
                                    │
                    ┌───────────────┼───────────────┐
                    ▼               ▼               ▼
           ┌──────────────┐ ┌─────────────┐ ┌─────────────────┐
           │  PostgreSQL  │ │  Pinecone   │ │    Inngest      │
           │  (Prisma)    │ │  (Vectors)  │ │(Background Jobs)│
           └──────────────┘ └─────────────┘ └─────────────────┘
                                                    │
                                                    ▼
                                          ┌─────────────────┐
                                          │  Google Gemini  │
                                          │   (AI/LLM)      │
                                          └─────────────────┘

Data Flow: Repository Connection & Indexing

┌──────────┐    ┌────────────┐    ┌─────────────┐    ┌──────────────┐
│  User    │───▶│ Connect    │───▶│  Create     │───▶│   Trigger    │
│  Clicks  │    │ Repository │    │  Webhook    │    │   Inngest    │
│ "Connect"│    │  Action    │    │  on GitHub  │    │    Event     │
└──────────┘    └────────────┘    └─────────────┘    └──────────────┘
                                                            │
                                                            ▼
┌──────────┐    ┌────────────┐    ┌─────────────┐    ┌──────────────┐
│ Stored   │◀──│  Upsert    │◀──│  Generate   │◀──│  Fetch All   │
│   in     │    │ to Pinecone│    │ Embeddings  │    │  Repo Files  │
│ Pinecone │    │  (Batched) │    │ (Google AI) │    │  (Octokit)   │
└──────────┘    └────────────┘    └─────────────┘    └──────────────┘

Data Flow: AI Code Review for Pull Requests

┌──────────┐    ┌────────────┐    ┌─────────────┐    ┌──────────────┐
│  GitHub  │───▶│  Webhook   │───▶│ reviewPull- │───▶│  Inngest     │
│    PR    │    │  Handler   │    │  Request()  │    │   Event      │
│  Event   │    │            │    │  Action     │    │ pr.review.*  │
└──────────┘    └────────────┘    └─────────────┘    └──────────────┘
                                                            │
                                                            ▼
┌──────────┐    ┌────────────┐    ┌─────────────┐    ┌──────────────┐
│ fetch-   │───▶│ retrieve-  │───▶│ generate-   │───▶│ post-comment │
│ pr-data  │    │ context    │    │ ai-review   │    │ & save-review│
│ (Octokit)│    │ (Pinecone) │    │ (OpenRouter)│    │ (GitHub/DB)  │
└──────────┘    └────────────┘    └─────────────┘    └──────────────┘

📁 Project Structure

inspectra/
├── app/                          # Next.js App Router
│   ├── (auth)/                   # Authentication routes
│   │   └── login/                # Login page
│   ├── (dashboard)/              # Protected dashboard routes
│   │   ├── dashboard/            # Main dashboard
│   │   ├── repository/           # Repository management
│   │   └── settings/             # User settings
│   ├── api/                      # API routes
│   │   ├── auth/                 # Better Auth endpoints
│   │   ├── inngest/              # Inngest webhook handler
│   │   └── webhooks/github/      # GitHub webhook receiver
│   ├── globals.css               # Global styles
│   ├── layout.tsx                # Root layout
│   └── page.tsx                  # Landing page
│
├── components/                   # React components
│   ├── ui/                       # shadcn/ui components
│   └── landing/                  # Landing page components
│
├── inngest/                      # Background job definitions
│   ├── client.ts                 # Inngest client
│   └── functions/                # Job functions
│       ├── index.ts              # Repository indexing jobs
│       └── review.ts             # AI code review job
│
├── lib/                          # Shared utilities
│   ├── auth.ts                   # Better Auth configuration
│   ├── db.ts                     # Prisma client
│   ├── pinecone.ts               # Pinecone client
│   └── generated/prisma/         # Generated Prisma client
│
├── module/                       # Feature modules
│   ├── ai/                       # AI module
│   │   ├── actions/              # Server actions
│   │   │   └── index.ts          # reviewPullRequest action
│   │   ├── lib/
│   │   │   ├── openrouter.ts     # OpenRouter provider
│   │   │   └── rag.ts            # RAG implementation
│   │   └── prompt.ts             # AI prompt generator
│   ├── auth/                     # Auth components & hooks
│   ├── dashboard/                # Dashboard components
│   ├── github/                   # GitHub integration
│   │   └── lib/
│   │       └── github.ts         # Octokit utilities
│   ├── repository/               # Repository management
│   └── settings/                 # Settings management
│
├── prisma/                       # Database schema
│   └── schema.prisma             # Prisma schema definition
│
├── providers/                    # React context providers
├── public/                       # Static assets
└── docs/                         # Documentation

🚀 Getting Started

Prerequisites

Node.js (v18 or later, LTS recommended)
Bun (recommended) or npm/pnpm
PostgreSQL database
GitHub Account with OAuth App credentials
Google AI (Gemini) API Key
Pinecone API Key and Index

Environment Variables

Create a .env file in the root directory:

# Database
DATABASE_URL="postgresql://user:password@host:5432/database?sslmode=require"

# Better Auth
BETTER_AUTH_SECRET="your-secret-key"
BETTER_AUTH_URL="http://localhost:3000"

# GitHub OAuth
GITHUB_CLIENT_ID="your-github-client-id"
GITHUB_CLIENT_SECRET="your-github-client-secret"

# AI & Vector Database
GOOGLE_API_KEY="your-google-ai-api-key"
OPENROUTER_API_KEY="your-openrouter-api-key"
PINECONE_DB_API_KEY="your-pinecone-api-key"

# Application
NEXT_PUBLIC_APP_BASE_URL="http://localhost:3000"

Installation

Clone the repository

git clone https://github.com/krishna9358/inspectra.git
cd inspectra

Install dependencies
```
bun install
# or
npm install
```
Set up the database
```
npx prisma generate
npx prisma db push
```
Start the development server
```
bun run dev
```

Start Inngest Dev Server (in a separate terminal)

npx --ignore-scripts=false inngest-cli@latest dev

Open http://localhost:3000 to view the application.

📚 Documentation

Detailed documentation is available in the /docs directory:

Architecture Overview - System design and data flow
API Reference - API endpoints and server actions
GitHub Integration - Webhooks and OAuth setup
RAG Implementation - Vector embeddings and retrieval
Inngest Jobs - Background job processing
Database Schema - Prisma models and relationships

🧪 Development

Available Scripts

Script	Description
`bun run dev`	Start development server
`bun run build`	Build for production
`bun run start`	Start production server
`bun run lint`	Run ESLint
`bun run test`	Run tests
`bun run prettier`	Format code

Running Tests

bun run test

🤝 Contributing

Contributions are welcome! Please read our contributing guidelines before submitting a PR.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📄 License

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

Built with ❤️ by Krishna Mohan

Name		Name	Last commit message	Last commit date
Latest commit History 95 Commits
.github/workflows		.github/workflows
.source		.source
app		app
components		components
config		config
docs		docs
hooks		hooks
inngest		inngest
lib		lib
module		module
prisma		prisma
providers		providers
public		public
.env.example		.env.example
.gitignore		.gitignore
README.md		README.md
bun.lock		bun.lock
components.json		components.json
eslint.config.mjs		eslint.config.mjs
justfile		justfile
next.config.ts		next.config.ts
package.json		package.json
postcss.config.mjs		postcss.config.mjs
prisma.config.ts		prisma.config.ts
todo		todo
ts-prune.json		ts-prune.json
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

🔍 Inspectra

📖 Overview

Why Inspectra?

✨ Features

🔍 AI-Powered Code Reviews

🔗 GitHub Integration

🧠 RAG Implementation

📊 Dashboard & Analytics

🔐 Authentication & User Management

⚙️ Background Processing

🛠️ Tech Stack

Frontend

Backend

AI & Machine Learning

Integrations

🏗️ Architecture

System Overview

Data Flow: Repository Connection & Indexing

Data Flow: AI Code Review for Pull Requests

📁 Project Structure

🚀 Getting Started

Prerequisites

Environment Variables

Installation

📚 Documentation

🧪 Development

Available Scripts

Running Tests

🤝 Contributing

📄 License

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages