Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧬 DevDNA AI

An evidence-based GitHub portfolio intelligence system that analyzes a developer's public GitHub profile, detects technical signals, generates a Developer DNA profile, identifies portfolio gaps, and recommends what to build next.

Python GitHub API AI Portfolio Analysis Status License


🚀 Overview

DevDNA AI analyzes a developer's public GitHub portfolio and converts repository-level evidence into an intelligent developer profile.

Instead of simply counting repositories or programming languages, DevDNA AI attempts to answer:

  • What kind of developer is this?
  • What are their strongest technical signals?
  • What skills are supported by repository evidence?
  • How ready is their portfolio?
  • Which repositories need improvement?
  • Where are the biggest portfolio gaps?
  • What type of project should they build next?

The system analyzes GitHub profile data, repository metadata, README signals, technical keywords, portfolio completeness, and evidence patterns to generate an explainable Developer DNA profile.


🧠 Key Features

🧬 Developer DNA Analysis

DevDNA AI evaluates a developer across multiple dimensions:

  • 🛠️ Builder
  • 🤖 AI Explorer
  • 👁️ Vision Specialist
  • ⚙️ Automation
  • 🌐 Web Creator
  • 📊 Data Explorer
  • 🔓 Open Source

Each dimension includes:

  • Score
  • Confidence level
  • Supporting evidence
  • Repository signals

🔍 GitHub Portfolio Analysis

The system analyzes:

  • Public repositories
  • Repository descriptions
  • Repository topics
  • Programming languages
  • README content
  • License signals
  • Repository metadata
  • Project activity
  • Technical keywords

🩺 Portfolio Readiness Score

DevDNA AI generates an overall portfolio readiness score out of 100 based on:

  • Projects
  • Documentation
  • Discoverability
  • Technology diversity
  • Portfolio activity

Example:

Portfolio Readiness: 84/100
Level: Strong Portfolio

🧭 Portfolio Gap Detection

The system automatically identifies weaknesses such as:

  • Weak documentation
  • Missing repository descriptions
  • Missing GitHub topics
  • Low repository completeness
  • Limited technology diversity
  • Weak project presentation

💡 Intelligent Project Recommendations

Based on Developer DNA and portfolio signals, DevDNA AI recommends high-value next projects.

🤖 Build a Full-Stack AI Product

Focus areas:

  • API Integration
  • Backend Development
  • AI Integration
  • Frontend or UI Design
  • Deployment

👁️ Real-Time Vision Intelligence System

Focus areas:

  • Computer Vision
  • Real-Time Processing
  • AI Models
  • System Design

⚙️ Intelligent Workflow Assistant

Focus areas:

  • Automation
  • Context Awareness
  • Voice or Assistant Technology
  • System Integration

🔬 Skill Evidence Map

DevDNA AI builds an evidence map connecting technical skills to repositories.

Example:

Python: 8 repositories
  • CodeGuardAI
  • Sentinel
  • PROJECT-ATLAS
  • PROJECT-MIRAGE-AI
  • EduVoice-AI

Computer Vision: 3 repositories
  • PROJECT-MIRAGE-AI
  • visionx-ai
  • Image-to-Sketch

Artificial Intelligence: 3 repositories
  • PROJECT-MIRAGE-AI
  • EduVoice-AI
  • FoodLink

This makes the system's conclusions transparent and explainable.


🏗️ Architecture

GitHub Profile
      │
      ▼
 GitHubClient
      │
      ▼
ProfileAnalyzer
      │
      ├──────────────┐
      ▼              ▼
EvidenceEngine   PortfolioAnalyzer
      │              │
      ▼              ▼
   DNAEngine    PortfolioEngine
      │              │
      ▼              ▼
ExplanationEngine
      │
      ▼
IntelligenceEngine
      │
      ├───────────────┐
      ▼               ▼
 Gap Detection   Recommendations
      │               │
      └───────┬───────┘
              ▼
      DevDNA AI Report

📁 Project Structure

DevDNA-AI/
│
├── app.py
├── requirements.txt
├── test_github.py
│
├── assets/
│
└── core/
    ├── github_client.py
    ├── profile_analyzer.py
    ├── portfolio_analyzer.py
    ├── portfolio_engine.py
    ├── evidence_engine.py
    ├── dna_engine.py
    ├── explanation_engine.py
    ├── intelligence_engine.py
    ├── gap_engine.py
    ├── health_engine.py
    ├── insight_engine.py
    └── recommendation_engine.py

⚙️ Core Modules

github_client.py

Handles communication with the GitHub API:

  • Fetching user profile data
  • Fetching repositories
  • Handling authentication
  • Handling API requests
  • Supporting authenticated GitHub API usage

profile_analyzer.py

Processes GitHub profile and repository metadata:

  • Public repository count
  • Repository descriptions
  • Repository topics
  • Portfolio metadata
  • Profile-level signals

evidence_engine.py

Extracts technical evidence related to:

  • Python
  • Web Applications
  • Artificial Intelligence
  • Machine Learning
  • Computer Vision
  • Computer Vision Models
  • Data Analysis
  • Automation
  • Voice Technology

dna_engine.py

Generates the core Developer DNA profile:

  • Builder
  • AI Explorer
  • Vision Specialist
  • Automation
  • Web Creator
  • Data Explorer
  • Open Source

It also determines primary strengths, developer persona, and confidence levels.

explanation_engine.py

Provides evidence-backed explanations for Developer DNA scores.

Example:

Builder
Score: 82%
Confidence: High

Evidence:
• 9 public repositories
• 8 repositories with descriptions
• 6 repositories with topics

portfolio_analyzer.py

Calculates overall portfolio readiness using:

  • Projects
  • Documentation
  • Discoverability
  • Diversity
  • Activity
  • Repository health

health_engine.py

Analyzes repository completeness using signals such as:

  • README availability
  • Description
  • Topics
  • License
  • Project presentation

Example:

PROJECT-MIRAGE-AI: 100/100 [Healthy]
Sentinel: 80/100 [Needs Attention]
CodeGuardAI: 60/100 [Incomplete]

intelligence_engine.py

Generates:

  • Portfolio gaps
  • Next-project recommendations
  • Strategic improvement suggestions

gap_engine.py

Identifies missing or weak portfolio signals:

  • Documentation
  • Discoverability
  • Repository Completeness
  • Technology Diversity

recommendation_engine.py

Suggests high-value project directions based on:

  • Developer DNA
  • Portfolio strengths
  • Portfolio gaps
  • Technical diversity

🔐 GitHub API Authentication

DevDNA AI can use the public GitHub API without authentication, but GitHub applies a much smaller request limit.

For more reliable analysis, you can optionally use a GitHub Personal Access Token.

Store the token locally and never upload it to GitHub.

Example:

GITHUB_TOKEN=your_personal_access_token

🛠️ Installation

1. Clone the repository

git clone https://github.com/palashgoyalatwork/DevDNA-AI.git
cd DevDNA-AI

2. Create a virtual environment

Windows

python -m venv venv
venv\Scripts\activate

3. Install dependencies

pip install -r requirements.txt

▶️ Running DevDNA AI

Run:

python test_github.py

Example:

Analyzing GitHub developer profile...
Username: palashgoyalatwork

📊 Example Output

============================================================
DEVDNA AI INTELLIGENCE REPORT
============================================================

Developer Persona: Product Builder

Description:
Your strongest portfolio signal is consistent
project building and technical execution.

Persona Confidence: High

Developer DNA

🧬 DEVELOPER DNA

- Builder: 82% [Confidence: High]
- AI Explorer: 33% [Confidence: Medium]
- Vision Specialist: 49% [Confidence: Medium]
- Automation: 8% [Confidence: Emerging]
- Web Creator: 39% [Confidence: Medium]
- Data Explorer: 25% [Confidence: Medium]
- Open Source: 77% [Confidence: High]

Primary Strengths

🔥 PRIMARY STRENGTHS

- Builder: 82%
- Open Source: 77%
- Vision Specialist: 49%

Portfolio Readiness

Portfolio Readiness: 84/100
Level: Strong Portfolio

Projects: 90/100
Documentation: 89/100
Discoverability: 67/100
Diversity: 96/100
Activity: 80/100

Repository Health

PROJECT-MIRAGE-AI: 100/100 [Healthy]
EduVoice-AI: 100/100 [Healthy]
Image-to-Sketch: 100/100 [Healthy]
FoodLink: 100/100 [Healthy]

Sentinel: 80/100 [Needs Attention]
visionx-ai: 80/100 [Needs Attention]

CodeGuardAI: 60/100 [Incomplete]

🎯 Project Philosophy

DevDNA AI is built around one central idea:

A GitHub profile should be analyzed as evidence of technical behavior, not simply as a collection of repositories.

A portfolio contains signals about:

  • What a developer builds
  • Which technologies they repeatedly use
  • How they document projects
  • Whether they work in specialized technical areas
  • How complete their repositories are
  • Which skills are supported by actual project evidence

DevDNA AI transforms these signals into a structured and explainable developer profile.


🔮 Future Improvements

  • Interactive Streamlit dashboard
  • Repository-level visual analytics
  • Developer DNA radar chart
  • GitHub profile comparison
  • Historical portfolio tracking
  • Contribution activity analysis
  • README quality scoring
  • Technology trend detection
  • AI-powered repository summaries
  • Exportable portfolio reports
  • Multi-profile comparison
  • Deployment as a public web application

🧪 Current Development Status

Core Analysis

  • GitHub API integration
  • GitHub authentication support
  • Profile analysis
  • Repository analysis
  • Technical evidence extraction
  • Developer DNA scoring
  • Confidence calculation
  • Evidence explanations
  • Portfolio readiness analysis
  • Repository health scoring
  • Portfolio gap detection
  • Intelligent project recommendations
  • Console intelligence report

Next Stage

  • Interactive dashboard
  • Data visualization
  • Developer DNA charts
  • Web interface
  • Exportable reports
  • Deployment

👨‍💻 Author

Palash Goyal

GitHub: @palashgoyalatwork

DevDNA AI was built as a portfolio intelligence project combining:

  • GitHub data analysis
  • Evidence extraction
  • AI-inspired developer profiling
  • Portfolio evaluation
  • Explainable scoring
  • Intelligent recommendations

📄 License

This project is licensed under the MIT License.


⭐ If You Like This Project

  • ⭐ Star the repository
  • 🍴 Fork the project
  • 🧠 Explore the Developer DNA system
  • 🛠️ Suggest new portfolio intelligence features
  • 🚀 Build on the analysis framework

DevDNA AI
Understand what your GitHub portfolio says about you.

About

AI-powered GitHub Portfolio Intelligence System that analyzes developer profiles, detects technical evidence, generates Developer DNA, identifies portfolio gaps, and recommends what to build next. Public: ✅

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages