项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1410
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Node.js v18.x 或更高版本
- Git 用于克隆仓库
- GitHub Token(强烈建议),避免匿名搜索 API 限流
- 一个可用的 LLM API Key(本地 Ollama 可用 local-fallback)
- 约数 GB 磁盘空间存放抓取到的项目数据
安装与启动步骤
-
1克隆项目仓库
把 hello-ai 仓库拉到本地并进入项目目录,后续所有命令都在该目录下执行。
git clone https://github.com/xxxily/hello-ai.git cd hello-ai -
2安装依赖
安装项目所需的 npm 依赖,首次执行耗时较长,需要保持网络稳定。
npm install -
3生成配置文件
从模板复制出 .env 文件,之后所有的密钥和参数都写在这个文件里。
cp .env.example .env -
4填写环境变量
打开 .env,至少填 GITHUB_TOKEN 和 LLM_API_KEY,并按需设置 LLM_PROVIDER、LLM_BASE_URL、LLM_MODEL。
-
5单次运行抓取评估
执行一次完整的发现与评估流程,验证 Token 和 LLM 配置是否正确,避免直接跑循环。
npm run ai:discover-eval -
6启动后台守护进程
需要持续自动抓取与评估时使用;TUI 版本支持手动选择参数,推荐优先使用。
npm run ai:loop-eval-tui -
7构建站点产物
为生产站点部署准备分发产物,生成到 docs 目录下。
npm run docs:build
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
GITHUB_TOKEN | 是 | GitHub 访问令牌,绕过匿名搜索 API 的严格限流 | ghp_xxxxxxxxxxxxxxxxxxxx |
LLM_API_KEY | 是 | 用于分析和筛选项目的 LLM 密钥;本地模型可填 local-fallback | sk-xxxxxxxx |
LLM_PROVIDER | 否 | 内置供应商预设,省略时从 BASE_URL 或密钥自动识别 | openai |
LLM_BASE_URL | 否 | LLM 接口地址,本地 Ollama 可指向 127.0.0.1 | https://api.openai.com/v1 |
LLM_MODEL | 否 | 调用的模型名称 | gpt-4o-mini |
LOOP_INTERVAL_SECONDS | 否 | ai:loop-eval 循环之间的空闲间隔,默认 60 秒 | 60 |
如何确认成功
运行 npm run ai:discover-eval 后终端持续输出发现/评估日志且无鉴权报错,docs:build 后 docs 目录生成产物,即配置成功。
常见问题
Q:不填 GITHUB_TOKEN 可以跑吗?
A:可以运行,但匿名调用 GitHub 搜索 API 会被严格限流,抓取速度和数量都会大幅受限,强烈建议填写。
Q:没有付费 LLM Key 怎么办?
A:使用本地模型,例如 Ollama 跑 llama3 时把 LLM_API_KEY 设为 local-fallback,并把 LLM_BASE_URL 指向本地地址即可。
Q:该跑哪一个启动命令?
A:手动跑一次用 npm run ai:discover-eval;长期自动运行推荐 npm run ai:loop-eval-tui,可交互选择参数。
Q:如何避免 GitHub 限流?
A:使用 npm run ai:consume-queue,它只消费队列不再请求 GitHub API,队列清空后会自动退出。
注意事项
- README 未给出本地开发服务器的启动端口,如需查看界面可直接使用官网 https://hello-ai.anzz.site/explore/。
- 可选屏蔽词可写入 BLOCKED_GITHUB_OWNERS 与 BLOCKED_REPO_TERMS,或放入默认的 data/local-blocklists/ 文件,每行一项、# 为注释。
- 各批量参数如 DISCOVER_BATCH_SIZE、EVALUATE_BATCH_SIZE、MAX_PAGES_DEFAULT 会直接影响抓取量与 API 消耗,建议先小批量试跑。
核心亮点
- 覆盖 ChatGPT、Claude、Gemini、Stable Diffusion 等主流工具,资源全面
- 教程和提示词整理系统,降低学习门槛,适合新手快速上手
- 中文内容为主,对中文用户友好,社区活跃,持续更新
不足之处
- 资源多为聚合整理,深度原创内容有限
- 文档/社区待观察
适用场景
- 个人学习 AI 工具入门与进阶
- 团队内部 AI 技能培训与知识共享
- 寻找特定 AI 工具的使用技巧和提示词
替代项目
AI-Resources、Awesome ChatGPT Prompts、AI Tool Master List
上一篇:ai-dev-gallery
下一篇:hello-agents
同类项目推荐
interspeech2019-tutorial
开源
跟着国际语音顶会教程,快速上手语音识别与合成
INTERSPEECH 2019 Tutorial Materials
rag-time
开源
五周从零上手 RAG,系统构建你的检索增强应用
RAG Time: A 5-week Learning Journey to Mastering RAG
StudentAI
开源
免提示词,学生直接问,AI 秒回学习答案
StudentAI is an prompt-less AI chatbot app that uses OpenAI's large language model t···
ai-tools
开源
用AI把文献综述从几周压缩到几小时
AI-powered literature review tools leverage machine learning to expedite and enhance···
claude-code-pro-course
开源
俄语通关 Claude Code:8 个实验带你配好 AI 编程代理
Claude Code PRO — полный курс и гайд на русском: CLAUDE.md,···
ChatGPT-Simple-Tutorial-Image-Te···
开源
快速上手 ChatGPT,学会生成图文代码并避开坑
️ A simple ChatGPT AI tutorial on how to generate images/text/code and its limitati···
mastering-github-copilot-for-dot···
开源
跟着课程练,把 Copilot 用成 C# 开发加速器
Master GitHub Copilot for C#/.NET development via this curriculum! Learn AI-driven p···
freelingo
开源
自托管 AI 私教,用本地大模型练口语背单词
Open-source, self-hosted AI language learning platform with local or cloud LLMs, CEF···
Deep-Learning-Coursera
开源
照着敲完深度学习专项课,代码能力稳了
Projects from the Deep Learning Specialization from deeplearning.ai provided by Cour···
