推荐一个 GitHub 开源项目信息卡片生成工具，支持Docker快速部署和API调用

luler · 2025-10-07T12:54:39+00:00

一、简介一个基于 FastAPI 和 Pillow 的 GitHub 仓库卡片生成工具，支持 Web 界面和 API 调用可以自动获取、更新github开源仓库信息，包括作者头像，仓库贡献者、issues、Fork、Star数量等动态渲染生成美观好看的信息卡片图片支持 Docker 快速安装部署项目...

luler

一、简介

一个基于 FastAPI 和 Pillow 的 GitHub 仓库卡片生成工具，支持 Web 界面和 API 调用
可以自动获取、更新github开源仓库信息，包括作者头像，仓库贡献者、issues、Fork、Star数量等
动态渲染生成美观好看的信息卡片图片
支持 Docker 快速安装部署
项目代码地址参考：https://github.com/luler/hello_github_card
该工具的工作原理与架构图可参考下图

二、安装

准备一台主机，提前安装好Docker、docker-compose软件环境

新建docker-compose.yml配置文件，配置内容如下：

version: '3'
services:
  github-card-generator:
    image: ghcr.io/luler/hello_github_card:latest
    restart: unless-stopped
    ports:
      - "8000:8000"
    volumes:
      # 持久化存储生成的图片
      - ./images:/app/images

执行如下命令，快速启动程序

docker-compose up -d

成功启动，服务将运行在8000端口，参考下图

三、使用

安装启动之后，可以通过访问页面、调用API等方式生成 github 的仓库信息卡片
访问页面，在线使用，访问地址：http://server_ip:8000/ ,页面展示如下

调用实时生成github仓库信息卡片接口，参考如下

接口（POST）：/api/generate
请求参数（json）：
{
    "repo_url": "https://github.com/luler/hello_github_card" //github仓库地址
}
返回（json）：
{
    "success": true,
    "message": "卡片生成成功",
    "data": {
        "owner": "microsoft",
        "repo_name": "vscode",
        "image_url": "/images/microsoft/vscode.png", //信息卡片图片
        "filename": "vscode.png",
        "repo_info": {
            "description": "Visual Studio Code", //仓库描述
            "stars": 177301, //Star数量
            "forks": 35380, //Fork数量
            "issues": 13887, //issue数量
            "contributors": 329 //贡献者数量
        }
    }
}

直接渲染生成信息卡片接口（信息卡片自动缓存、自动更新，可以直接作为图片链接使用）

接口（GET）：/github/{owner}/{repo_name}
请求参数（url参数）：
owner：仓库作者
repo_name：仓库名称
返回（binary）：
信息卡片图片数据

请求示例参考下图

四、总结

这是个简易的小工具，可以帮助快速生成好看的开源github仓库信息卡片图片，可用于交流分享、开源导航
支持Docker快速部署，提供在线页面和API，使用起来非常方便，且易于集成

该工具的演示地址参考：https://cas.luler.top/?search=68de28ca84a3a