快速搭建一个 GitHub 开源项目导航网站，提供便捷的信息抓取、智能摘要、分类管理功能

一、简介

• 一个基于 FastAPI 的 GitHub 项目推荐与导航网站，支持多级分类、仓库搜索和 GitHub 仓库信息展示
• 提供在线后台管理，支持分类管理、快速添加开源仓库信息、LLM 自动摘要
• 自动抓取Star、Fork、贡献者、作者、项目描述等信息，并生成美观的 Github 仓库信息卡片
• 该工具的开源地址参考：https://github.com/luler/hello_github_share
• 可以访问在线演示地址查看效果：https://gitshare.luler.top/
• 这个工具的系统结构和工作流可以参考下图：
  

二、安装

• 提前安装准备好git、Docker、docker-compose软件环境
• 拉取项目代码

  git clone https://github.com/luler/hello_github_share.git

• 进入代码目录，查看编辑docker-compose.yml配置文件，把修改的变量修改成你需要的，配置内容如下：

  services:
    github-navigator:
      image: ghcr.io/luler/hello_github_share:latest
      restart: unless-stopped
      ports:
        - "8000:8000"
      environment:
        # 管理员账号配置（可选，不设置则使用默认值 admin/admin123）
        - ADMIN_USERNAME=${ADMIN_USERNAME:-admin}
        - ADMIN_PASSWORD=${ADMIN_PASSWORD:-admin123}
        - GITCARD_BASE_URL=${GITCARD_BASE_URL:-http://localhost:3000} #这个是生成信息卡片的地址
        - JWT_SECRET=${JWT_SECRET:-vdidDXhbSN} #这个是jwt秘钥，修改成复杂的
      volumes:
        # 持久化数据库文件
        - .:/app

  注意GITCARD_BASE_URL的地址需要部署一个Github 信息卡片工具，获得对应的访问地址，参考：https://blog.luler.top/d/87

• 执行如下命令启动项目

  docker-compose up -d

  执行完成，服务就运行起来了，就可以访问相关端口使用了
  

三、使用

• 服务安装完成后，可以访问网站，在线登录管理分类和仓库信息

• 访问页面：http://server_ip:8000/，点击登录管理后台
  

• 初始账号密码就是docker-compose.yml文件上配置的环境变量，默认账号：admin，密码：admin123
  

• 登录完成可以配置使用大语言模型，以便可以自动爬取并摘要开源项目的信息
  

• 多级分类管理
  

• 添加修改开源项目信息，可使用大语言模型赋能自动摘要
  

• 首页仓库列表展示，支持分类搜索、仓库信息搜索
  

四、总结

• 该工具可以帮助用户管理自己开发的和收藏的开源项目，分门别类，简单摘要，以便后续快速定位检索与使用
• 该工具支持使用Docker快速部署启用，低资源占用
• 集成 Jina.ai 信息抓取、LLM 自动摘要辅助功能、github开源项目信息卡片，智能添加开源项目，省心省力