
karpathy-llm-wiki
把散落资料变成 AI 可直接调用的结构化知识库
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2710
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 可执行 npx 的 Node.js 环境(npx 由 Node.js 提供)
- 支持 Agent Skills 标准的 AI 编程工具,如 Claude Code、Cursor、Codex
- 本地有一个可写的项目目录,用于存放 raw/ 与 wiki/ 等知识库内容
安装与启动步骤
-
1安装 Skill
在项目目录下执行 npx 命令,把该 skill 添加到你的 Agent 工具中。README 明确给出的唯一安装方式。
npx add-skill Astro-Han/karpathy-llm-wiki -
2查看技能规范
阅读仓库根目录的 SKILL.md,了解完整的 skill 规范与三个操作的调用方式,再开始使用。
-
3准备原始资料
把要沉淀的源材料放入 raw/ 目录,作为 Ingest 操作的输入;README 说明 Agent 会把源材料收集到 raw/。
-
4执行 Ingest
让 Agent 做 Ingest:把源材料收集进 raw/、分类整理,并创建或更新 wiki/ 下的知识页面;无新内容时只记日志。具体调用方式见 SKILL.md。
-
5执行 Query 提问
让 Agent 做 Query:检索 wiki/ 页面并给出带引文的回答,回答链接到对应的 markdown 页面。
-
6执行 Lint 检查
让 Agent 做 Lint:检查索引完整性、链接与 wiki 健康状况,自动修复并报告问题,保持知识库一致性。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
raw/ | 是 | 存放原始资料的目录,Ingest 操作会把源材料收集到这里 | raw/ |
wiki/ | 是 | 编译产出的结构化知识页面目录,Query 从这里检索并引用 | wiki/ |
examples/ | 否 | README 提到的示例目录,含示例 wiki 页面、源文件和操作日志 | examples/ |
如何确认成功
安装后 Agent 工具中能看到该 skill;按 SKILL.md 执行 Ingest 后 wiki/ 下出现新页面,Query 能返回带页面引文的回答。
常见问题
Q:支持哪些 AI 编程工具?
A:README 说明适用于任何支持 Agent Skills 标准的工具,并点名 Claude Code、Cursor、Codex 等。
Q:它和 RAG 有什么区别?
A:README 给出对比表:该方案把知识编译成持久化的 wiki markdown 页面,合成发生在 Ingest 阶段;提问时直接引用已合成的页面,而不是每次重新检索原始文档。
Q:知识库内容保存在哪里?
A:按 README 描述,原始资料在 raw/,编译后的知识页面在 wiki/,均在本地 markdown 文件中,可作为个人知识库长期维护。
Q:安装后怎么知道有哪些操作?
A:README 列出三个操作:Ingest、Query、Lint,完整规范见仓库根目录的 SKILL.md。
注意事项
- README 只提供了 npx add-skill 这一条安装命令,其余操作需按 SKILL.md 执行。
- README 展示的 Usage Stats(94 篇文章、13 个主题目录、99 份源材料)来自维护者的生产知识库,仅作参考,不代表初始状态。
- 原始资料与知识页面均为 markdown,建议纳入 Git 版本管理以便回溯。
核心亮点
- 兼容 Claude Code、Cursor、Codex 多种主流 Agent 工具,开箱即用
- 内置引文和 linting 机制,保证知识库内容可溯源、质量可控
- 从原始源自动构建 Karpathy 风格知识库,降低人工整理成本
不足之处
- 项目处于成长早期,文档和社区生态尚待完善
- 知识库构建质量依赖原始资料质量,对输入源要求较高
适用场景
- 团队沉淀大模型开发最佳实践,供 AI 编程工具调用
- 个人开发者系统化整理 LLM 学习笔记,形成可复用知识库
- 企业将内部技术文档转化为 AI 可读的知识资产,提升编码效率
替代项目
Dify、LangChain、LlamaIndex
同类项目推荐
ollama_pdf_rag
开源
本地跑通 PDF 问答,数据不出门
A full-stack demo showcasing a local RAG (Retrieval Augmented Generation) pipeline t···
Smartlmager
开源
用一句话或一张图,秒搜你的整个图库
一个基于多模态向量模型及视觉多模态模型构建的图片搜索引擎&管理系统,实现精准的以文搜文···
grepai
开源
让 AI 代理本地语义搜代码、看调用关系,不传云端
Semantic Search & Call Graphs for AI Agents (100% Local)
my-wiki
开源
本地优先的 AI 知识库,让 AI 回答有据可查
Local-first AI knowledge app and Agent Skill with evidence-backed Wiki, an interacti···
arona
开源
给文档站加一个能听懂人话的 AI 搜索
Elysia AI doc search
zbyai
开源
用 AI 把搜索从关键词升级为问答,直接给答案
ZByAI - AI-Enhanced Search
ontobricks
开源
把 Databricks 表变成可推理知识图谱,直接喂给 AI Agent
Transforms Databricks Unity Catalog tables into a dynamic knowledge graph, with onto···
deep-searcher
开源
在私有数据上,像专业研究员一样深度搜索并生成报告
Open Source Deep Research Alternative to Reason and Search on Private Data. Written ···
RAG-Play
开源
可视化 RAG 流程,一眼看懂检索生成每一步
An interactive visualization tool for understanding Retrieval-Augmented Generation (···