GITHUB.SIGNAL

English: An AI-powered GitHub trending intelligence dashboard with a constructivist / futurist visual identity, bilingual repo summaries, domain filters, and commercialization analysis.

中文：一个 AI 驱动的 GitHub 热门项目情报看板，结合构成主义 / 未来主义视觉风格，提供中英双语简介、领域筛选和商业化分析。

Overview | 项目简介

GITHUB.SIGNAL is built for developers, founders, indie hackers, and curious builders who want more than a plain trending list.

It turns GitHub hot projects into a signal dashboard: what is trending, what the project actually does, which domain it belongs to, and whether it may have real commercial potential.

GITHUB.SIGNAL 面向开发者、创业者、独立开发者，以及希望快速获取高质量开源信号的人群。它不只是展示“谁最火”，而是进一步回答：项目属于什么领域、核心价值是什么、是否具有商业化前景。

Features | 功能亮点

• Live GitHub trending aggregation: combines GitHub Trending and Search API signals

• Bilingual interface: instant EN / ZH switching across the UI

• Domain filtering: AI, Web, DevTools, Infra, Security, Data, Mobile, Blockchain, Game Dev

• AI summaries: bilingual repo descriptions generated for readability and context

• Commercialization analysis: AI-assisted business potential rating and go-to-market direction hints

• Theme switching: dark + light presentation modes

• Direct repo jump: click any project and open the source repository immediately

• Long-scroll reading experience: optimized for browsing many projects instead of forcing a single-screen layout

• 实时热门聚合：结合 GitHub Trending 与 Search API 的双数据源

• 双语界面切换：支持中英文即时切换

• 领域筛选：支持 AI、Web、开发工具、基础设施、安全、数据、移动端、区块链、游戏开发等方向

• AI 双语简介：自动生成更易读、更有上下文的项目摘要

• 商业化分析：给出商业潜力评级与可能方向建议

• 亮色 / 暗色主题：适应不同阅读偏好

• 仓库直达：点击即可跳转到对应 GitHub 仓库

• 长滚动浏览体验：更适合连续发现和比较多个项目

Screenshot Section | 截图区

This repository currently does not bundle screenshot assets. Recommended screenshots for the repo homepage:

1. Overview / 总览页: dark theme homepage with trending cards
2. AI Analysis / AI 分析页: cards showing bilingual summary + commercialization analysis
3. Light Theme / 亮色主题: same dataset under light mode

Demo | 演示

Local Demo

python server.py

Open in browser:

http://localhost:8090

AI Analysis Setup

Set your DeepSeek API key before using AI analysis:

$env:DEEPSEEK_API_KEY="your_api_key"
python server.py

Demo Flow

1. Open the dashboard

2. Choose language, domain, time range, and item count

3. Click SCAN

4. Click AI ANALYZE

5. Read bilingual summaries and commercialization suggestions

6. 打开仪表盘

7. 选择语言、领域、时间范围与项目数量

8. 点击 SCAN

9. 点击 AI ANALYZE

10. 查看双语简介与商业化建议

Use As An AI Skill | 作为 AI Skill 使用

If you want to use the GitHub discovery logic inside an AI workflow instead of opening the local dashboard directly, this project can also be packaged and used as a reusable skill.

如果你希望把这个能力作为 AI 工作流中的一个可复用模块，而不是只在本地网页中使用，那么它也可以被封装成一个 skill 来调用。

What the skill does | Skill 能做什么

• fetch GitHub trending projects from multiple sources

• merge and rank hot repositories

• filter by language or domain

• summarize what each project does

• estimate commercialization potential

• 从多个来源抓取 GitHub 热门项目

• 合并并排序热门仓库

• 按语言或领域筛选

• 总结项目用途

• 评估商业化潜力

Typical prompts | 常见触发方式

Examples:

Find today's hottest GitHub repos
Show me trending AI open source projects this week
每日 GitHub 热门项目推荐
帮我找最近最火的 AI 开源项目

How to install the skill | 如何安装 skill

This repo includes the project implementation, while the reusable skill should live in your Claude skills directory.

这个仓库保存的是项目实现；真正可复用的 skill 文件应当放在你的 Claude skills 目录里。

Recommended location:

~/.claude/skills/github-trending-scout/

Core files:

• SKILL.md — skill metadata and workflow instructions
• scripts/fetch_trending.py — fetches and merges trending GitHub repos

How the AI should use it | AI 应该如何调用

The AI should:

1. run the fetch script with the user's filters
2. read the JSON output
3. summarize each repo
4. assess commercial potential
5. present the result in the user's preferred language

AI 的推荐调用步骤：

1. 根据用户条件运行抓取脚本
2. 读取 JSON 结果
3. 总结每个项目的作用
4. 评估商业化潜力
5. 用用户偏好的语言输出结果

Example skill command | 示例 skill 调用

python scripts/fetch_trending.py --top 10 --since daily --language python

Notes | 说明

• The skill version is best for terminal / agent workflows.

• The dashboard version in this repo is best for visual browsing and interactive filtering.

• skill 版本更适合终端 / agent 工作流。

• 本仓库里的 dashboard 版本更适合可视化浏览和交互式筛选。

Architecture | 架构说明

Browser UI (index.html)
  -> /api/trending
      -> GitHub Trending page
      -> GitHub Search API
      -> merge + ranking + domain filter
  -> /api/analyze
      -> DeepSeek V4 Flash
      -> bilingual summary + business analysis

Components

• index.html A single-file frontend with the full visual system, filtering controls, theme switching, bilingual UI, and card rendering.

• server.py A lightweight Python server that:

  • serves the frontend
  • aggregates trending repo data
  • filters by domain keywords
  • proxies AI analysis requests to DeepSeek
  • batches large AI jobs to reduce 502 errors

Design Principles

• fast signal over noisy exploration

• visually memorable, not generic dashboard styling

• bilingual by default

• low setup cost

• easy to modify and self-host

• 强调高质量信号，而不是噪声式浏览

• 视觉风格鲜明，不做普通后台模板

• 默认支持双语

• 启动成本低

• 易于自定义与自托管

Privacy & Security | 隐私与安全

• No API key is stored in this repository

• AI features require DEEPSEEK_API_KEY from environment variables

• Runtime logs are excluded from version control

• 仓库中不保存任何 API 密钥

• AI 功能通过环境变量 DEEPSEEK_API_KEY 提供凭据

• 运行日志不会提交到版本库

Author | 作者

GitHub: @zhangtianruiwork-droid

License | 开源协议

This project is released under the MIT License.

本项目基于 MIT License 开源。