Github Repository Analyzer

Comprehensive GitHub repository analysis with code quality scoring, tech stack detection, contributor bus factor, dependency audit, and AI-powered insights.

What it does

This actor analyzes any GitHub repository and provides:

• Basic Info: Stars, forks, license, topics, archive status
• Tech Stack: Languages, frameworks, build tools, package managers
• Contributors: Bus factor, contribution distribution (Gini coefficient), top contributors
• Dependencies: Package count, direct vs dev dependencies
• Activity: Commit frequency, staleness score, release history
• Quality: Tests, CI/CD, linting, documentation scores
• AI Insights: Executive summary, strengths, concerns, risk assessment

Use Cases

• Due Diligence: Evaluate open-source dependencies before adoption
• Hiring: Assess candidate GitHub portfolios objectively
• Investment: Technical due diligence on startup codebases
• Competitive Analysis: Understand competitor tech stacks
• Open Source: Evaluate project health before contributing

Input

{
  "repositories": ["facebook/react", "microsoft/vscode"],
  "analysisDepth": "standard",
  "includeAiSummary": true,
  "openaiApiKey": "sk-...",
  "githubToken": "ghp_...",
  "maxConcurrency": 3
}

Input Parameters

Parameter	Type	Required	Description
repositories	array	Yes	Repository URLs or owner/repo format
analysisDepth	string	No	quick, standard, or deep (default: standard)
includeAiSummary	boolean	No	Generate AI insights (default: true)
openaiApiKey	string	No	Required for AI summaries
githubToken	string	No	Increases rate limit from 60 to 5000/hour
maxConcurrency	integer	No	Parallel repos (default: 3, max: 10)

Analysis Depths

• Quick: Basic info + languages only (~2 API calls)
• Standard: + Contributors, dependencies, activity (~8 API calls)
• Deep: + Quality metrics, AI insights (~12 API calls + OpenAI)

Output

{
  "repositoryUrl": "https://github.com/facebook/react",
  "owner": "facebook",
  "name": "react",
  "basicInfo": {
    "description": "The library for web and native user interfaces",
    "stars": 220000,
    "forks": 45000,
    "license": "MIT",
    "topics": ["javascript", "react", "frontend"]
  },
  "techStack": {
    "primaryLanguage": "JavaScript",
    "languagePercentages": { "JavaScript": 85.2, "TypeScript": 10.1 },
    "frameworks": ["React"],
    "buildTools": ["Rollup"]
  },
  "contributors": {
    "total": 1600,
    "busFactor": 12,
    "giniCoefficient": 0.78,
    "top10": [...]
  },
  "activity": {
    "commitsLastMonth": 45,
    "daysSinceLastCommit": 2,
    "stalenessScore": 0,
    "releaseCount": 150
  },
  "quality": {
    "hasTests": true,
    "hasCI": true,
    "hasLinting": true,
    "overallScore": 95
  },
  "aiInsights": {
    "summary": "React is a mature, actively maintained UI library...",
    "strengths": ["Large community", "Comprehensive testing", "Regular releases"],
    "concerns": ["High bus factor concentration", "Complex contribution process"],
    "maintenanceRisk": "low",
    "recommendation": "Safe for production use with long-term support expected"
  }
}

Key Metrics Explained

Bus Factor

Minimum number of contributors responsible for 50% of commits. Low numbers (1-2) indicate risk if those developers leave.

Gini Coefficient

Measures contribution inequality (0 = perfectly equal, 1 = one person does everything). High values suggest over-reliance on few contributors.

Staleness Score

0-100 scale based on days since last commit:

• 0-10: Active (< 30 days)
• 10-50: Moderate (30-180 days)
• 50-80: Stale (6-12 months)
• 80-100: Abandoned (> 1 year)

Quality Score

0-100 composite score based on:

• README completeness (30%)
• Tests presence (20%)
• CI/CD setup (15%)
• Linting config (10%)
• TypeScript (10%)
• Documentation files (15%)

Pricing

Pay per result:

• $0.03 per repository (quick)
• $0.05 per repository (standard)
• $0.10 per repository (deep)

Plus OpenAI API costs if using AI summary (~$0.01-0.02 per repository).

Rate Limits

Without GitHub token: 60 requests/hour (analyze ~5-7 repos) With GitHub token: 5000 requests/hour (analyze ~400+ repos)

Get a token at: https://github.com/settings/tokens

Examples

Analyze a single repository

{
  "repositories": ["anthropics/claude-code"],
  "analysisDepth": "deep",
  "includeAiSummary": true
}

Quick scan of multiple repos

{
  "repositories": [
    "vercel/next.js",
    "facebook/react",
    "vuejs/vue",
    "sveltejs/svelte"
  ],
  "analysisDepth": "quick",
  "includeAiSummary": false
}

Full analysis with authentication

{
  "repositories": ["your-org/private-repo"],
  "analysisDepth": "deep",
  "githubToken": "ghp_xxxxxxxxxxxx",
  "openaiApiKey": "sk-xxxxxxxxxxxx"
}

Limitations

• Private repositories require a GitHub token with appropriate permissions
• Repositories with 10,000+ commits may have limited contributor stats
• Some metrics require the repository to have been active recently
• AI insights require an OpenAI API key

Support

For issues or feature requests, please open an issue on the actor's GitHub repository.