Skip to main content

Team Analyzer — Internal Documentation

Module: vartovii/modules/crypto/services/team_analyzer.py Last Updated: 2026-01-06

Purpose​

Analyze project team composition using GitHub API for Pre-Launch project scoring.

Usage​

from vartovii.modules.crypto.services.team_analyzer import get_team_analyzer

analyzer = get_team_analyzer()
result = analyzer.analyze("solana-labs")

# Returns:
{
    "org": "solana-labs",
    "team_size": 156,
    "team_score": 85,
    "core_contributors": [
        {"login": "aeyakovenko", "contributions": 2341, "avatar": "..."},
        {"login": "jstarry", "contributions": 1823, "avatar": "..."},
        ...
    ]
}

Data Extraction​

From GitHub API:​

  • /orgs/{org} — Org info (followers, public_repos)
  • /orgs/{org}/repos?sort=stars — Top 5 repos
  • /repos/{org}/{repo}/contributors — Contributors per repo

Aggregation:​

  • Merge contributors across all repos
  • Sum contributions per user
  • Sort by total contributions
  • Return top 15

Team Score Calculation​

Base score: 50

Team Size:

  • ≥50 contributors: +25
  • ≥20 contributors: +15
  • ≥5 contributors: +5
  • <3 contributors: -20

Top Contributor Activity:

  • 500 commits: +10

  • 100 commits: +5

Org Credibility:

  • 10K followers: +15

  • 1K followers: +10

  • 100 followers: +5

Environment Variables​

GITHUB_TOKEN=ghp_xxx  # Optional but recommended for rate limits

Without token: 60 requests/hour With token: 5,000 requests/hour

UI Integration​

<TeamCard members={team_data.core_contributors.slice(0, 5)} />

Shows top 5 contributors with:

  • Avatar
  • Username
  • Contribution count