GitHub Contributor Analytics Generator

A comprehensive analytics and reporting system for tracking GitHub repository contributions, generating insights, and creating static contributor profile pages.

Website | Discord | DAO | Docs

elizaos/eliza permalinks:

• https://elizaos.github.io/data/daily/contributors.json
  • https://elizaos.github.io/data/daily/summary.json
  • https://elizaos.github.io/data/daily/summary.md
• https://elizaos.github.io/data/weekly/contributors.json
• https://elizaos.github.io/data/monthly/contributors.json

older versions are backed up in data/*/history folders with timestamps

Features

• Daily, Weekly, and Monthly Reports

  • Automated data collection via GitHub Actions
  • Detailed activity summaries with metrics and trends
  • Smart contributor scoring system
  • AI-powered activity summaries
  • Thread-style weekly summaries for social sharing

• Contributor Profiles

  • Interactive profile pages for each contributor
  • Activity visualization with charts and metrics
  • Contribution history and engagement tracking
  • Responsive design with dark mode support

• Activity Tracking

  • Pull request analysis with file-level changes
  • Issue tracking with label analytics
  • Commit history and impact measurement
  • Engagement metrics (comments, reviews, etc.)

Setup

1. Configure GitHub Authentication:

# Set your GitHub access token
export GH_ACCESS_TOKEN=\"your_token\"

# For AI-powered summaries (optional)
export OPENAI_API_KEY=\"your_key\"

2. Install Dependencies:

Bun is recommended for this project.

# Install Python dependencies
pip install openai langchain-core langchain-ollama

# Install Node.js dependencies
bun install
# OR if you are too lazy to install bun
npm install

3. Configure Repository Settings:

# Update repository details in fetch_github.sh
owner=\"your_org\"
repo=\"your_repo\"

Usage

Manual Data Collection

# Fetch recent activity
./scripts/fetch_github.sh owner repo --type prs --days 7
./scripts/fetch_github.sh owner repo --type issues --days 7
./scripts/fetch_github.sh owner repo --type commits --days 7

# Process and combine data
python scripts/combine.py -p data/prs.json -i data/issues.json -c data/commits.json -o data/combined.json

# Calculate contributor scores
python scripts/calculate_scores.py data/combined.json data/scored.json

# Generate summaries
python scripts/summarize.py data/scored.json data/contributors.json --model openai

# Generate weekly thread summary
bash scripts/generate_history_summaries.sh

Weekly Thread Generation

The system can generate social media-friendly thread summaries of weekly activity:

1. Automatic Generation: Part of weekly workflow, runs every Friday
2. Manual Generation: Run generate_history_summaries.sh
3. Output Location: data/weekly/thread_[DATE].txt
4. Content:
   • Comprehensive weekly summary in thread format
   • Key metrics and achievements
   • Notable PRs and improvements
   • Future priorities and goals

Automated Reports

The included GitHub Actions workflow (weekly-summaries.yml) automatically:

• Runs daily at 5:00 PM EST
• Generates weekly reports and threads on Fridays
• Creates monthly summaries on the 4th of each month

Generate Static Site

# Build and generate contributor profile pages
bun run build

# View the site
bunx serve@latest out

Or use npm...

Data Structure

The system generates structured JSON data for contributors:

{
  \"contributor\": \"username\",
  \"score\": number,
  \"avatar_url\": \"string\",
  \"summary\": \"string\",
  \"activity\": {
    \"code\": {
      \"total_commits\": number,
      \"total_prs\": number,
      \"commits\": array,
      \"pull_requests\": array
    },
    \"issues\": {
      \"total_opened\": number,
      \"opened\": array
    },
    \"engagement\": {
      \"total_comments\": number,
      \"comments\": array
    }
  }
}

Customization

• Modify scoring algorithms in calculate_scores.py
• Adjust summary generation in summarize.py
• Customize profile pages in ContributorProfile.js
• Configure report schedules in weekly-summaries.yml
• Customize thread format in generate_history_summaries.sh

Directory Structure

.
├── data/               # Generated data and reports
├── scripts/           # Core processing scripts
│   ├── combine.py     # Data aggregation
│   ├── calculate_scores.py    # Scoring system
│   ├── summarize.py   # Summary generation
│   └── generate_history_summaries.sh  # Thread generation
├── profiles/          # Generated static site
└── .github/workflows  # Automation workflows

Requirements

• Python 3.11+
• Node.js 18+
• GitHub Personal Access Token
• OpenAI API Key (optional, for AI summaries)

Contributors

Notes

code2prompt -p README.md -p scripts/build.js -p scripts/components/ContributorProfile.js -p package.json -p profiles/madjin.html``,message: docs: add weekly thread generation feature documentation`