Skip to content

About

An intelligent codebase analyzer & live Lighthouse PageSpeed audit portal. Auto-scans dependencies, maps database schemas, audits hosted SEO/best practices, and enables RAG-based AI chat consultations for local and remote repositories.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

Repository files navigation

🚀 DevInsight AI - Intelligent Codebase & Web PageSpeed Analytics

License: MIT Python Version Django Version Aesthetic Mode Lighthouse Auditor

DevInsight AI is an advanced, production-grade intelligence platform that analyzes local and remote repositories, parses technology dependencies, runs automated security/SEO audits, and evaluates live hosted website PageSpeed metrics (using Google Lighthouse curves).


🌟 Key Features

  • 💻 Deep Codebase Auditing: Analyze repositories locally or clone them remotely via Git. Auto-extract libraries, database schemas, API routes, and code-level concerns.
  • 🤖 RAG Chat Coding Assistant: Ask architecture questions, explain complex code, or design database schemas directly with a local-first RAG vector index.
  • 📈 Google Lighthouse Emulator: Evaluate hosted URLs directly from the dashboard:
    • Performance: Mobile and desktop scoring curves matching Google PageSpeed Insights LCP/FCP benchmarks.
    • Accessibility: Audits HTML language attributes, semantic structural elements, image alt text compliance, and form labels.
    • Best Practices: Evaluates HTTPS secure sockets, response headers, and target-blank link safety.
    • SEO: Validates indexing keywords, title and meta lengths, viewport layouts, and H1 distribution.
  • 🔍 W3Techs Tech Stack Scanner: Parses live site response headers and source structures to extract backend languages (PHP, Python, ASP.NET), client libraries (React, Next.js, jQuery), and web servers (Nginx, Apache, Cloudflare).
  • 🐳 Dockerized Development: Zero dependency setup with single-command Docker environments.

🗺️ Architectural Workflow

graph TD
    User([User]) -->|Inputs Git URL / Local Path| DevInsight[DevInsight AI Portal]
    User -->|Inputs Hosted URL| Auditor[Lighthouse Auditor]
    
    subgraph Repo Analysis Engine
        DevInsight -->|Git Service| Cloner[Cloner / Reader]
        Cloner -->|AST Parser| Parser[Tree-Sitter / Language Extractor]
        Parser -->|RAG Vectorization| ChromaDB[(Chroma Vector DB)]
        ChromaDB -->|LLM Prompt Context| AI[AI Advisor / Advisor RAG]
    end

    subgraph Host Audit Engine
        Auditor -->|HTTP Scraper| Scraper[Target Site Scraper]
        Scraper -->|W3Techs Scanner| TechDetect[Technology Detector]
        Scraper -->|SEO & Alt audits| Landmarks[Landmarks & Heuristics Evaluator]
        Landmarks -->|Lighthouse Curves| Gauges[Mobile & Desktop SVG Gauges]
    end

    AI -->|Response| User
    Gauges -->|Dashboard Visuals| User
Loading

🛠️ Technology Stack

  • Backend: Django 5.1, Django Rest Framework, Celery, PostgreSQL / SQLite.
  • AI & Search Vector DB: OpenAI, Anthropic, Google Generative AI, ChromaDB, SentenceTransformers.
  • Parsers: Tree-Sitter AST (Abstract Syntax Tree) Parser, GitPython, PyDriller.
  • Frontend: Vanilla CSS3, SVG gauges, and asynchronous AJAX chat handlers.

🚀 Getting Started

📋 Prerequisites

Make sure you have installed:


📦 Local Installation (Manual Setup)

  1. Clone the Repository:

    git clone https://github.com/dev-amit-dots/DevInsightAI.git
    cd DevInsightAI
  2. Setup Virtual Environment:

    python -m venv venv
    # On Windows:
    .\venv\Scripts\activate
    # On macOS/Linux:
    source venv/bin/activate
  3. Install Dependencies:

    pip install -r requirements.txt
  4. Run Database Migrations:

    python manage.py makemigrations
    python manage.py migrate
  5. Create Superuser (Optional):

    python manage.py createsuperuser
  6. Start the Development Server:

    python manage.py runserver

    Access the dashboard at http://localhost:8000/.


🐳 Docker Installation (Quick Setup)

Run the entire application including Celery workers and Redis caching using Docker Compose:

docker-compose up --build

Access the application at http://localhost:8000/.


🧪 Running Tests

Verify your local installation is fully correct by executing the Django/pytest test suite:

# Run pytest ignoring data volumes
.\venv\Scripts\pytest.exe --ignore=data

🔐 Credentials for Demo Login

  • Username/Email: test@mailinator.com
  • Password: Test@123

📄 License

Distributed under the MIT License. See LICENSE for details.


👤 Author

Amit Tiwari

About

An intelligent codebase analyzer & live Lighthouse PageSpeed audit portal. Auto-scans dependencies, maps database schemas, audits hosted SEO/best practices, and enables RAG-based AI chat consultations for local and remote repositories.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages