DevLens 🔍

High-performance AI-powered GitHub repository intelligence platform delivering multi-model architectural analysis, automated code quality & risk audits, voice-guided AI assistance, and comparative benchmarks.

---

✨ Features

• ⚡ 6-Tier Resilient AI Engine: Zero-downtime AI cascade routing across Groq (LLaMA 3.3 70B), Google Gemini (2.5/2.0), OpenRouter, Cohere (Command R+), Hugging Face, and Mistral AI.
• 🎙️ Voice Assistant & Waveform: Integrated Web Speech API Speech-to-Text (STT) with live CSS audio waveform visualization and natural Text-to-Speech (TTS) voice narration.
• 🔬 Deep Architecture & Risk Audits: Automated detection of architectural anti-patterns, maintainability bottlenecks, and community health risks.
• 📊 Interactive Code Analytics: 52-week commit activity heatmaps, language composition breakdowns, contributor rankings, and issue resolution metrics.
• ⚖️ Side-by-Side Comparison: Head-to-head repository evaluation with AI-generated architectural verdicts.
• 📝 Automated README Generator: Instant generation of structured, production-ready documentation.
• 📄 Executive PDF Reports: Export high-resolution analytical reports with charts and executive summaries.
• ⚡ High-Speed SQLite Caching: Instant retrieval of previously analyzed repositories.

---

🚀 Tech Stack

Frontend

• React 18.2 & Vite
• Lucide React & Framer Motion
• Web Speech API (Speech Recognition & Speech Synthesis)
• D3.js & Recharts (Visualizations)
• jsPDF & html2canvas (Report Export)

Backend

• ASP.NET Core (.NET 8.0) Web API
• Entity Framework Core with SQLite
• Multi-Provider AI Client (IAiService)
• GitHub REST API v3 Client

---

📋 Prerequisites & Environment Variables

Backend .env Configuration

Create a .env file in the backend/ directory:

# GitHub Token (5,000 requests/hr)
GITHUB_TOKEN=your_github_token_here

# 6-Tier AI Provider Keys
GROQ_API_KEY=your_groq_key_here
GEMINI_API_KEY=your_gemini_key_here
OPENROUTER_API_KEY=your_openrouter_key_here
COHERE_API_KEY=your_cohere_key_here
HUGGINGFACE_API_KEY=your_hf_key_here
MISTRAL_API_KEY=your_mistral_key_here

# Allowed CORS Origins (comma-separated)
CORS_ORIGINS=http://localhost:5173,https://your-frontend.vercel.app

---

🛠️ Installation & Local Setup

1. Clone the Repository

git clone https://github.com/charan-kumar99/DevLens.git
cd DevLens

2. Backend Setup

cd backend
dotnet restore
dotnet build
dotnet run

Backend runs on http://localhost:5000 or configured port.

3. Frontend Setup

cd ../frontend
npm install
npm run dev

Frontend runs on http://localhost:5173.

---

🌐 Deployment

• Frontend: Deploy to Vercel with environment variable VITE_API_URL=https://your-backend.onrender.com.
• Backend: Deploy to Render as a Docker web service with the .env keys in the Environment settings.

---

👨‍💻 Author

Built with ❤️ by Charan Kumar.