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

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:

GEMINI_API_KEY=your-key-here

2. Start the Engines

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

make migrate
make seed

4. Install the VS Code Extension

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

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

Loading

---

Roadmap

• Initial VS Code Extension Release
• Django Backend and Kafka Integration
• Support for IntelliJ IDEA / WebStorm
• Advanced AI Career Path Recommendations
• Team-level Analytics Dashboard

---

Project Structure

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 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 file for details.

_{Built by the Developer DNA Open Source Community}