Collect information about dependencies between a github repo and other repositories. Results available in JSON, markdown and badges.

These details have not been verified by PyPI

Project links

Project description

github-dependents-info

Collect information about dependencies between a github repo and other repositories.

🚀 Features

GitHub API does not allow to collect information about package usage (Used by on home, Dependents in insights section)

This package uses GitHub HTML to collect dependents information and can:

Automate all the actions below using a simple GitHub Action !
Output as text
Output as json (including shields.io markdown badges)
Generate summary markdown file
Optionally add an AI-generated usage summary (via litellm) when an LLM API key is present
Update existing markdown by inserting Used by badge within tags
-  [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=22&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)
Handle multiple repositories packages
Filter results using minimum stars or by repository owner
Keep huge ecosystems manageable with pagination controls (--max-scraped-pages, --pagination/--no-pagination, --page-size)
Fetch dependents faster thanks to asynchronous httpx requests and parallelized page scraping

AI usage summary (optional)

If an LLM API key is detected in the environment (for example OPENAI_API_KEY), the tool will call a lightweight model (via litellm) to generate a short usage summary and include it in the generated markdown.

Supported provider env vars (most common):
- OpenAI: OPENAI_API_KEY
- Azure OpenAI: AZURE_OPENAI_API_KEY
- Anthropic: ANTHROPIC_API_KEY
- Google Gemini: GEMINI_API_KEY (or GOOGLE_API_KEY)
- Mistral: MISTRAL_API_KEY
- Cohere: COHERE_API_KEY
- Groq: GROQ_API_KEY
Disable with --no-llm-summary (or env var GITHUB_DEPENDENTS_INFO_LLM_SUMMARY=false)
Override model with --llm-model (or env var GITHUB_DEPENDENTS_INFO_LLM_MODEL / LITELLM_MODEL)
Adjust max summary length with --llm-max-words (or env var GITHUB_DEPENDENTS_INFO_LLM_MAX_WORDS)
The summary is cached in --csvdirectory (file llm_summary_<repo>.json) and reused on subsequent runs

Badges example

JSON output

Note: when AI usage summary is enabled and an LLM API key is present, the JSON output also includes llm_summary.

{
    "all_public_dependent_repos": [
        {
            "name": "CIT-SeniorDesign/CIT-SeniorDesign.github.io",
            "stars": 0
        },
        {
            "name": "Moaz-Adel/Jobsity-Challenge",
            "stars": 0
        },
        {
            "name": "Moaz-Adel/automation-exercise-cypress",
            "stars": 0
        },
        {
            "name": "RecuencoJones/vscode-groovy-lint-issue",
            "stars": 0
        },
        {
            "name": "aboe026/data-structures",
            "stars": 0
        },
        {
            "name": "aboe026/shields.io-badge-results",
            "stars": 0
        },
        {
            "name": "aboe026/software-update-checker",
            "stars": 2
        },
        {
            "name": "katalon-labs/katalon-recorder-extension",
            "stars": 0
        },
        {
            "name": "mashafrancis/sa-jenkins",
            "stars": 0
        },
        {
            "name": "nvuillam/vscode-groovy-lint",
            "stars": 52
        },
        {
            "name": "run2cmd/dotfiles",
            "stars": 2
        }
    ],
    "packages": [
        {
            "id": null,
            "name": "nvuillam/npm-groovy-lint",
            "url": "https://github.com/nvuillam/npm-groovy-lint/network/dependents",
            "public_dependent_stars": 56,
            "public_dependents": [
                {
                    "name": "CIT-SeniorDesign/CIT-SeniorDesign.github.io",
                    "stars": 0
                },
                {
                    "name": "Moaz-Adel/Jobsity-Challenge",
                    "stars": 0
                },
                {
                    "name": "Moaz-Adel/automation-exercise-cypress",
                    "stars": 0
                },
                {
                    "name": "RecuencoJones/vscode-groovy-lint-issue",
                    "stars": 0
                },
                {
                    "name": "aboe026/data-structures",
                    "stars": 0
                },
                {
                    "name": "aboe026/shields.io-badge-results",
                    "stars": 0
                },
                {
                    "name": "aboe026/software-update-checker",
                    "stars": 2
                },
                {
                    "name": "katalon-labs/katalon-recorder-extension",
                    "stars": 0
                },
                {
                    "name": "mashafrancis/sa-jenkins",
                    "stars": 0
                },
                {
                    "name": "nvuillam/vscode-groovy-lint",
                    "stars": 52
                },
                {
                    "name": "run2cmd/dotfiles",
                    "stars": 2
                }
            ],
            "public_dependents_number": 11,
            "private_dependents_number": 4,
            "total_dependents_number": 15,
            "badges": {
                "total": "[![](https://img.shields.io/static/v1?label=Used%20by&message=15&color=informational&logo=slickpic)](https://github.com/nvuillam/npm-groovy-lint/network/dependents)",
                "public": "[![](https://img.shields.io/static/v1?label=Used%20by%20(public)&message=11&color=informational&logo=slickpic)](https://github.com/nvuillam/npm-groovy-lint/network/dependents)",
                "private": "[![](https://img.shields.io/static/v1?label=Used%20by%20(private)&message=4&color=informational&logo=slickpic)](https://github.com/nvuillam/npm-groovy-lint/network/dependents)",
                "stars": "[![](https://img.shields.io/static/v1?label=Used%20by%20(stars)&message=56&color=informational&logo=slickpic)](https://github.com/nvuillam/npm-groovy-lint/network/dependents)"
            }
        }
    ],
    "total_dependents_number": 15,
    "public_dependents_number": 11,
    "private_dependents_number": 4,
    "public_dependents_stars": 56,
    "badges": {
        "total": "[![](https://img.shields.io/static/v1?label=Used%20by&message=15&color=informational&logo=slickpic)](https://github.com/nvuillam/npm-groovy-lint/network/dependents)",
        "public": "[![](https://img.shields.io/static/v1?label=Used%20by%20(public)&message=11&color=informational&logo=slickpic)](https://github.com/nvuillam/npm-groovy-lint/network/dependents)",
        "private": "[![](https://img.shields.io/static/v1?label=Used%20by%20(private)&message=4&color=informational&logo=slickpic)](https://github.com/nvuillam/npm-groovy-lint/network/dependents)",
        "stars": "[![](https://img.shields.io/static/v1?label=Used%20by%20(stars)&message=56&color=informational&logo=slickpic)](https://github.com/nvuillam/npm-groovy-lint/network/dependents)"
    }
}

Markdown output for single package

# Dependents stats for nvuillam/npm-groovy-lint

## Package nvuillam/npm-groovy-lint

[![](https://img.shields.io/static/v1?label=Used%20by&message=15&color=informational&logo=slickpic)](https://github.com/nvuillam/npm-groovy-lint/network/dependents)
[![](https://img.shields.io/static/v1?label=Used%20by%20(public)&message=11&color=informational&logo=slickpic)](https://github.com/nvuillam/npm-groovy-lint/network/dependents)
[![](https://img.shields.io/static/v1?label=Used%20by%20(private)&message=4&color=informational&logo=slickpic)](https://github.com/nvuillam/npm-groovy-lint/network/dependents)
[![](https://img.shields.io/static/v1?label=Used%20by%20(stars)&message=56&color=informational&logo=slickpic)](https://github.com/nvuillam/npm-groovy-lint/network/dependents)

| Repository                                                                                                    | Stars |
|:--------------------------------------------------------------------------------------------------------------|------:|
| [CIT-SeniorDesign/CIT-SeniorDesign.github.io](https://github.com/CIT-SeniorDesign/CIT-SeniorDesign.github.io) |     0 |
| [Moaz-Adel/Jobsity-Challenge](https://github.com/Moaz-Adel/Jobsity-Challenge)                                 |     0 |
| [Moaz-Adel/automation-exercise-cypress](https://github.com/Moaz-Adel/automation-exercise-cypress)             |     0 |
| [RecuencoJones/vscode-groovy-lint-issue](https://github.com/RecuencoJones/vscode-groovy-lint-issue)           |     0 |
| [aboe026/data-structures](https://github.com/aboe026/data-structures)                                         |     0 |
| [aboe026/shields.io-badge-results](https://github.com/aboe026/shields.io-badge-results)                       |     0 |
| [aboe026/software-update-checker](https://github.com/aboe026/software-update-checker)                         |     2 |
| [katalon-labs/katalon-recorder-extension](https://github.com/katalon-labs/katalon-recorder-extension)         |     0 |
| [mashafrancis/sa-jenkins](https://github.com/mashafrancis/sa-jenkins)                                         |     0 |
| [nvuillam/vscode-groovy-lint](https://github.com/nvuillam/vscode-groovy-lint)                                 |    52 |
| [run2cmd/dotfiles](https://github.com/run2cmd/dotfiles)                                                       |     2 |

_Generated by [github-dependents-info](https://github.com/nvuillam/github-dependents-info)_

Note: If your repository packages have millions of dependents, running github-dependent-infos could take hours, as it works by browsing and scraping HTML pages returned by GitHub. For example, angular/angular dependents did run during several hours !

Installation
Usage
Examples
Use as GitHub Action

⚙️ Installation

pip install -U github-dependents-info

or install with Poetry

poetry add github-dependents-info

🛠️ Usage

    github-dependents-info [OPTIONS]

Parameter	Type	Description
--repo	String	Repository. Example: `oxsecurity/megalinter`
-b --badgemarkdownfile	String	(optional) Path to markdown file where to insert/update Used by badge (must contain tags `<!-- gh-dependents-info-used-by-start -->` … `<!-- gh-dependents-info-used-by-end -->`)
-s --sort	String	(optional) Sort order: name (default) or stars
-x --minstars	String	(optional) If set, filters repositories to keep only those with more than X stars
-m --markdownfile	String	(optional) Output markdown file file
-d --docurl	String	(optional) Hyperlink to use when clicking on badge markdown file badge. (Default: link to markdown file)
-p --mergepackages	String	(optional) In case of multiple packages, merge their stats in a single one in markdown and json output
-j --json	String	(optional) Output in json format
-u --owner	String	(optional) If set, filters repositories to keep only those owned by the specified user/organization
-n --max-scraped-pages	Integer	(optional) Maximum number of GitHub pages to scrape per package (0 uses all available pages)
--pagination --no-pagination	Boolean	(optional) Enable (default) or disable pagination when writing markdown output
--page-size	Integer	(optional) Number of repositories per markdown page when pagination is enabled (default: 500)
--llm-summary --no-llm-summary	Boolean	(optional) Generate an AI usage summary in markdown output when an LLM API key is present (default: enabled)
--llm-model	String	(optional) LiteLLM model to use for the summary. If not set, a lightweight model is selected based on the detected API key provider
--llm-max-repos	Integer	(optional) Max dependent repos included in the summary prompt payload (default: 500)
--llm-max-words	Integer	(optional) Max words for the generated summary (default: 300)
--llm-timeout	Float	(optional) Timeout (seconds) for the summary LLM call (default: 120)
-v --version	Boolean	(optional) Displays version of github-dependents-info
--verbose	Boolean	(optional) Verbose output

Badge tags example (the tool replaces everything between the markers):

<!-- gh-dependents-info-used-by-start -->
[![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=22&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)
<!-- gh-dependents-info-used-by-end -->

🧪 Examples

Text output

github-dependents-info --repo nvuillam/npm-groovy-lint

JSON output

github-dependents-info --repo nvuillam/npm-groovy-lint --json

Insert/Update Used by markdown badge within an existing markdown file containing tags  [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=22&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)
```
github-dependents-info --repo nvuillam/npm-groovy-lint --badgemarkdownfile ./README.md
```

Build markdown file with dependent repos (single package), sorted by name

github-dependents-info --repo nvuillam/npm-groovy-lint --markdownfile ./docs/package-usage.md --verbose

Build markdown file with dependent repos (single package), with minimum 10 stars

github-dependents-info --repo nvuillam/npm-groovy-lint --markdownfile ./docs/package-usage.md --minstars 10 --verbose

Build markdown file with dependent repos (multiple package), sorted by stars

github-dependents-info --repo oxsecurity/megalinter --markdownfile ./docs/package-usage.md --sort stars --verbose

Build markdown file with dependent repos (multiple package), with merged list of packages in output markdown

github-dependents-info --repo oxsecurity/megalinter --markdownfile ./docs/package-usage.md --sort stars --mergepackages --verbose

Limit scraping to repositories owned by a specific organization and cap pagination to 5 pages per package

github-dependents-info --repo oxsecurity/megalinter --owner oxsecurity --max-scraped-pages 5 --verbose
Generate paginated markdown with 250 repositories per page (use --no-pagination to force a single file)

github-dependents-info --repo nvuillam/npm-groovy-lint --markdownfile ./docs/package-usage.md --page-size 250 --mergepackages
Disable AI usage summary generation

github-dependents-info --repo nvuillam/npm-groovy-lint --markdownfile ./docs/package-usage.md --no-llm-summary
Force a specific LiteLLM model for the summary

github-dependents-info --repo nvuillam/npm-groovy-lint --markdownfile ./docs/package-usage.md --llm-model gpt-4o-mini
Generate markdown with AI summary using OPENAI_API_KEY

GEMINI_API_KEY=YOUR_KEY github-dependents-info --repo nvuillam/npm-groovy-lint --markdownfile ./docs/package-usage.md --llm-model gemini-3-flash-preview

Use as GitHub Action

Allow GitHub Actions to create Pull Requests in Settings > Actions > General

Create a file .github/workflows/github-dependents-info.yml in your repository with the following YAML content.

If will generate a new Pull Request (or replace the pending one) every time the usage stats will have changed :)

Don't forget to add tags  [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=22&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md) in your README.md, at the end of another badge line if you want github-dependents-info to replace its content automatically.

# GitHub Dependents Info workflow
# More info at https://github.com/nvuillam/github-dependents-info/
name: GitHub Dependents Info

# Let by default
on:
  # On manual launch
  workflow_dispatch:
  # On every push on selected branches (usually just main)
  push:
    branches: [main,master,setup-gdi]
  # Scheduled interval: Use CRON format https://crontab.guru/
  schedule:
    - cron: "0 0 * * 0" # Every sunday at midnight

permissions: read-all

concurrency:
  group: ${{ github.ref }}-${{ github.workflow }}
  cancel-in-progress: true

jobs:
  build:
    name: GitHub Dependents Info
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    steps:
      # Git Checkout
      - name: Checkout Code
        uses: actions/checkout@v6
        with:
          token: ${{ secrets.PAT || secrets.GITHUB_TOKEN }}
          fetch-depth: 0

      # Collect data & generate markdown
      - name: GitHub Dependents Info
        uses: nvuillam/github-dependents-info@v1.6.3 # If you want to always have the latest version, you can use nvuillam/github-dependents-info@main :)
        # See documentation for variables details: https://github.com/nvuillam/github-dependents-info?tab=readme-ov-file#%EF%B8%8F-usage
        with:
          repo: ${{ github.repository }}
          outputrepo: ${{ github.repository }}
          # markdownfile: docs/github-dependents-info.md
          # badgemarkdownfile: README.md
          # sort: stars
          # minstars: "0"
          # llm-summary: "true" # set to "false" to disable AI usage summary
          # llm-model: "" # optional: override LiteLLM model (example: gpt-4o-mini, gemini-3-flash-preview)
          # llm-max-repos: "500" # optional: cap repos sent to the summary prompt
          # llm-max-words: "250" # optional: cap summary length
          # llm-timeout: "120" # optional: timeout (seconds) for the LLM call
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          # To enable the AI usage summary, provide one of the supported provider API keys, for example:
          # OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
          # GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}

      # Workaround for git issues
      - name: Prepare commit
        run: sudo chown -R $USER:$USER .

      # Create pull request
      - name: Create Pull Request
        id: cpr
        uses: peter-evans/create-pull-request@v8
        with:
          token: ${{ secrets.PAT || secrets.GITHUB_TOKEN  }}
          branch: github-dependents-info-auto-update
          commit-message: "[GitHub Dependents Info] Updated markdown file(s)"
          delete-branch: true
          title: "[GitHub Dependents Info] Updated markdown file"
          body: "_Generated with [github-dependents-info](https://github.com/nvuillam/github-dependents-info), by [Nicolas Vuillamy](https://github.com/nvuillam)_"
          labels: documentation
      - name: Create PR output
        run: |
          echo "Pull Request Number - ${{ steps.cpr.outputs.pull-request-number }}"
          echo "Pull Request URL - ${{ steps.cpr.outputs.pull-request-url }}"

🛡 License

This project is licensed under the terms of the MIT license. See LICENSE for more details.

Credits

This package has been inspired by stackexchange post How to use GitHub API to get a repository's dependents information in GitHub?

This project was generated with python-package-template

Project details

These details have not been verified by PyPI

Project links

Release history Release notifications | RSS feed

This version

3.0.0

Dec 25, 2025

2.0.2

Dec 14, 2025

2.0.1

Dec 14, 2025

2.0.0

Dec 14, 2025

1.6.3

Mar 3, 2024

1.6.2

Feb 26, 2024

1.6.1

Feb 20, 2024

1.6.0

Feb 20, 2024

1.5.1

Dec 31, 2023

1.5.0

Dec 29, 2023

1.4.0

Dec 20, 2023

1.3.2

Dec 18, 2023

1.3.1

Dec 18, 2023

1.3.0

Dec 18, 2023

1.2.0

Aug 4, 2023

1.1.0

May 17, 2023

1.0.1

May 1, 2023

1.0.0

Apr 6, 2023

0.10.0

Apr 1, 2023

0.9.0

Feb 5, 2023

0.8.0

Dec 27, 2022

0.7.2

Nov 20, 2022

0.7.1

Nov 20, 2022

0.7.0

Nov 17, 2022

0.6.0

Nov 15, 2022

0.5.0

Nov 14, 2022

0.4.1

Nov 13, 2022

0.4.0

Nov 13, 2022

0.3.0

Nov 13, 2022

0.2.0

Nov 13, 2022

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

github_dependents_info-3.0.0.tar.gz (26.6 kB view details)

Uploaded Dec 25, 2025 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

github_dependents_info-3.0.0-py3-none-any.whl (22.5 kB view details)

Uploaded Dec 25, 2025 Python 3

File details

Details for the file github_dependents_info-3.0.0.tar.gz.

File metadata

Download URL: github_dependents_info-3.0.0.tar.gz
Upload date: Dec 25, 2025
Size: 26.6 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: poetry/2.2.1 CPython/3.12.3 Linux/6.11.0-1018-azure

File hashes

Hashes for github_dependents_info-3.0.0.tar.gz
Algorithm	Hash digest
SHA256	`a1c37be9454c43d0ebb4f93c03b32e48cc10232f607cd697f56f5674304508f8`
MD5	`0215d51ca426cc567eda9944d15a31b6`
BLAKE2b-256	`f2f0166dbda81c892dbf9f1e3c904944ff4fae59f2242147c27a692443e91001`

See more details on using hashes here.

File details

Details for the file github_dependents_info-3.0.0-py3-none-any.whl.

File metadata

Download URL: github_dependents_info-3.0.0-py3-none-any.whl
Upload date: Dec 25, 2025
Size: 22.5 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: poetry/2.2.1 CPython/3.12.3 Linux/6.11.0-1018-azure

File hashes

Hashes for github_dependents_info-3.0.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`d33a3942c4811b5ed5adf2931cc68ba31d1ef98fba7724c879995bf33281627e`
MD5	`ad2a78697432922f1fa3b7119dc5c464`
BLAKE2b-256	`c6a21ade9d57237d805862bc683da3d16a5ad30c3ee1d9260ef4e80f555bd25b`

See more details on using hashes here.

github-dependents-info 3.0.0

Navigation

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

github-dependents-info

🚀 Features

AI usage summary (optional)

⚙️ Installation

🛠️ Usage

🧪 Examples

Use as GitHub Action

🛡 License

Credits

Project details

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

File details

File metadata

File hashes