repo-people¶
repo-people is a Python package that collects and exports the full GitHub profile data for every person associated with a repository — contributors, maintainers, stargazers, watchers, issue/PR authors, fork owners, commit authors and dependents.
from repo_people import RepoPeople
rp = RepoPeople("owner", "repo", token="ghp_...")
user_data = rp.get_users(export=True)
Key features¶
Collects users from 9 role categories in a single call.
Fetches 30+ profile fields per user (bio, location, company, followers, orgs, …).
Computes derived metrics: account age, followers/following ratio, repos/year, recently active flag, bot detection.
Incremental fetch with
save_each_iteration=Trueandresume=True— safe to interrupt and restart on large repositories.Flexible filtering:
roles,exclude,exclude_bots,limit,fields.Export to JSON, CSV and Markdown table.
Analysis helpers:
summarise()andtop_users().
Installation¶
pip install repo-people
Contents
- Usage
- Installation
- Quick Start
- Authentication
- Token Validation
- Input Validation
- Choosing an Output Directory
- Filtering by Role
- Skipping CODEOWNERS or Collaborators
- Limiting the Number of Results
- Excluding Users
- Incremental Fetching (Resume Support)
- Filtering the Output Fields
- Roles in Output Records
- Exporting Results
- Analysis Helpers
- Using the Lower-Level API
- Rate-Limit Tips
- Concurrent Fetching
- Async Fetching
- Exporting as JSON Lines (JSONL)
- API Reference
- Contributing