AI-powered developer telemetry platform that continuously analyzes your coding activity to generate insights on productivity, skill growth, debugging patterns, and career progression.

Think Spotify Wrapped for developers, powered by real telemetry from your IDE.

--- ## The Vision: Your Coding Journey, Quantified Developers write thousands of lines of code, debug countless complex errors, and adopt new frameworks daily. Yet, there is no definitive way to reflect on these achievements, visualize skill growth, or identify workflow bottlenecks. **Developer DNA** solves this by acting as your personal engineering analyst. It is an open-source initiative designed to help you quantify your coding journey. By capturing granular IDE events in the background, Developer DNA builds a comprehensive profile of your engineering habits and leverages advanced AI to provide actionable insights. --- ## See It In Action

The intuitive, dark-mode Next.js dashboard providing real-time AI insights.

--- ## What It Does Developer DNA transforms raw telemetry into a meaningful narrative of your career. It delivers a personalized, data-driven reflection of your work, enabling you to: - **Understand Your Workflow:** Visualize your productivity peaks, coding heatmaps, and focus periods. - **Track Skill Progression:** Monitor the languages and frameworks you use most and see your mastery evolve over time. - **Analyze Debugging Patterns:** Review your error distribution and understand how you tackle and resolve complex bugs. - **Plan Career Growth:** Receive AI-generated insights and reports on your strengths and areas for improvement. --- ## How It Does It The platform operates on a robust, scalable architecture designed for privacy and performance. 1. **Seamless IDE Integration:** A VS Code extension silently watches your typing, git operations, and terminal errors. It runs with zero impact on your local machine's performance. 2. **Asynchronous Processing Pipeline:** Telemetry data is streamed via Apache Kafka, ensuring high throughput and decoupled processing. Background workers handle data ingestion safely into PostgreSQL. 3. **Advanced AI Analysis:** A 5-agent LangGraph pipeline, powered by LLMs like Gemini and Qwen, analyzes the raw data. It categorizes events into distinct dimensions: Skill, Productivity, Debug, Career, and Report generation. 4. **Rich Data Visualization:** A sleek Next.js interface presents the insights, pulling processed analytics securely from a Django REST framework API. 5. **Privacy First Design:** Your code telemetry remains under your control. Secrets are never exposed, and the system can be run entirely on your local infrastructure. --- ## Installation & Setup ### Prerequisites - Docker Desktop (with Docker Compose v2+) - Node.js 22+ - Python 3.12+ - A free Gemini API key ### 1. Clone & Configure ```bash git clone https://github.com/Nyx-abu/developer-dna.git cd developer-dna cp .env.example .env ``` Edit `.env` and add your Gemini API key: ```env GEMINI_API_KEY=your-key-here ``` ### 2. Start the Engines ```bash make up ``` This single command spins up PostgreSQL, Kafka, the Django REST API, background workers, and the Next.js frontend. ### 3. Run Migrations & Seed Data ```bash make migrate make seed ``` ### 4. Install the VS Code Extension ```bash cd extension npm install npm run compile ``` Press `F5` in VS Code to launch the Extension Development Host and start tracking. Dashboard available at: **http://localhost:3000** --- ## Architecture Flow ```mermaid graph TD; subgraph Client VSC[VS Code Extension] end subgraph Backend Core API[Django DRF API] Kafka[Apache Kafka] Worker[Kafka Consumer Worker] DB[(PostgreSQL)] end subgraph AI Pipeline LangGraph[LangGraph Agents] FAISS[(FAISS Vector Store)] end subgraph Frontend Next[Next.js Dashboard] end VSC -- Batch POST Events --> API API -- Publish --> Kafka Kafka -- Consume --> Worker Worker -- Store Raw Data --> DB Worker -- Trigger Analysis --> LangGraph LangGraph -- RAG Context --> FAISS LangGraph -- Store Insights --> DB Next -- Fetch Insights --> API ``` --- ## Project Structure ```text developer-dna/ ├── backend/ # Django 5 + DRF + LangGraph agents ├── frontend/ # Next.js 14 dashboard (React, Tailwind) ├── extension/ # VS Code extension telemetry watchers ├── docs/ # Images and architecture documentation ├── docker-compose.yml └── Makefile ``` --- ## Contributing We welcome contributions from the community. Please read our [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on how to report bugs, suggest features, and submit pull requests. Let's build the ultimate developer tool together. --- ## License This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

_{Built by the Developer DNA Open Source Community}