llm-wiki-compiler

丢进原始资料,自动生成互联 Wiki 知识库

llm-wiki-compiler 是一个将原始知识源自动编译为相互关联的 Wiki 的知识编译工具。它受 Karpathy 的 LLM Wiki 模式启发,旨在解决从零散资料(如文档、网页、笔记)构建结构化知识库的痛点。核心能力包括:自动抽取实体与概念、生成双链关系、构建层级目录,并利用 LLM 对内容进行摘要与重组。用户只需提供原始文件或 URL,工具即可输出一套完整的、可导航的 Wiki 站点,支持 Markdown 格式,便于后续编辑与发布。它本质上是一个'知识管道',将非结构化的输入转化为结构化的知识网络,适用于个人知识管理、团队文档沉淀、研究资料整理等场景。

开源 free 开源模型
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 2100
维护状态 活跃
是否开源 是
定价模式 free

项目数据

分类开源模型
开发团队atomicstrata
所属国家
定价模式free
价格说明开源项目,MIT 许可证,可自由使用和部署,无付费版本。
访问状态
是否开源是
开源协议MIT
主要语言TypeScript
技术栈/模型cli,compiler,context-engineering,karpathy,knowledge-base,knowledge-compilation,llm,markdown,obsidian,wiki
GitHub 星标★ 2100
30天Star增速
HF 下载量
上线时间2026-04-05 00:00:00
最近更新2026-09-23 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数1

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 8 步

环境要求

  • Node.js 24 或更高版本(README 明确的最低要求)
  • npm 包管理器(用于全局安装 CLI)
  • 至少一个 LLM 供应商的 API Key(默认 Anthropic)
  • 可选:本地 Claude Code / Codex CLI / Ollama 等本地登录或服务

安装与启动步骤

  1. 1确认 Node 版本

    先检查本机 Node 版本,必须为 24 或更高,否则后续全局安装的 CLI 无法正常运行。

    node -v
  2. 2全局安装 CLI

    通过 npm 全局安装 llm-wiki-compiler,安装后即可在任意目录使用 llmwiki 命令。

    npm install -g llm-wiki-compiler
  3. 3配置默认 API Key

    默认供应商为 Anthropic,需导出密钥环境变量;示例值仅为占位,请换成你自己的真实 Key。

    export ANTHROPIC_API_KEY=sk-xxxxxxxx
  4. 4切换其他供应商

    如需使用 OpenAI 兼容接口或 Ollama,改用 LLMWIKI_PROVIDER 加对应密钥,例如 openai 需同时提供 OPENAI_API_KEY。

    export LLMWIKI_PROVIDER=openai
    export OPENAI_API_KEY=sk-xxxxxxxx
    export OPENAI_BASE_URL=https://api.openai.com/v1
  5. 5查看内置模板

    列出可用的声明式模板,确认安装成功并能读取内置目录。

    llmwiki template list
  6. 6检查模板内容

    查看 autosci 模板的具体配置与示例,了解它包含哪些记录类型和工作流。

    llmwiki template inspect autosci
  7. 7初始化模板

    把 autosci 模板初始化到当前项目中,作为构建领域 Wiki 的起点。

    llmwiki template init autosci
  8. 8校验配置与工作流

    校验 profile 配置是否合法,并列出模板定义的工作流,确认生命周期配置可用。

    llmwiki profile validate
    llmwiki workflow list

关键配置

配置项必填说明示例
ANTHROPIC_API_KEY是默认 Anthropic 供应商的密钥,也可用 ANTHROPIC_AUTH_TOKEN 替代。sk-xxxxxxxx
LLMWIKI_PROVIDER否切换模型供应商,可选 claude-agent、codex-agent、openai、ollama、copilot、atlascloud、orcarouter openai
OPENAI_API_KEY否使用 OpenAI 兼容供应商时必填的 API 密钥。sk-xxxxxxxx
OPENAI_BASE_URL否OpenAI 兼容接口的自定义地址,用于接入第三方兼容服务。https://api.openai.com/v1
OLLAMA_HOST否选用 Ollama 供应商时指定的本地服务地址。http://localhost:11434
GITHUB_TOKEN否使用 GitHub Copilot 供应商时的令牌,可用 gh auth token 生成。ghp_xxxxxxxx

如何确认成功

运行 llmwiki template list 能正常列出模板(如 autosci、newsroom),即说明 CLI 安装与运行环境正常。

常见问题

Q:Node 版本不够怎么办?

A:README 明确要求 Node.js 24 或更新版本,请升级 Node 后重新执行 npm install -g llm-wiki-compiler。

Q:如何换成非 Anthropic 的模型?

A:通过环境变量 LLMWIKI_PROVIDER 指定供应商,并按对应行配置密钥,如 openai 配 OPENAI_API_KEY、ollama 配 OLLAMA_HOST。

Q:模板里包含可执行插件代码吗?

A:不包含。README 说明模板只包含配置和示例,永远不含可执行插件代码,因此更安全。

Q:怎样共享自己写的模板?

A:可用 llmwiki template publish 构建 Ed25519 签名的离线分发包,消费方通过可信 tap 发现并校验后安装。

Q:使用 Codex CLI 供应商要注意什么?

A:需要本地 Codex 登录或 ChatGPT 订阅,并设置 LLMWIKI_PROVIDER=codex-agent,且必须显式指定 embedding 供应商。

注意事项

  • README 未给出完整的“编译原始资料”命令,实际生成 Wiki 的步骤请参考官网 https://llmwiki.atomicstrata.ai 与 docs 目录文档。
  • 不同供应商所需环境变量差异较大,切换前请先对照 README 的 Provider 表格确认。
  • 所有密钥请勿写入版本库,建议通过 shell 会话或密钥管理工具注入环境变量。
  • 模板支持签名分发、密钥轮换与吊销,安装第三方 tap 前需将其显式加入信任列表。

核心亮点

  • 自动化程度高:无需手动整理,直接生成带双链的 Wiki 结构
  • 基于 LLM 智能抽取实体与关系,提升知识关联度
  • 支持多种输入源,输出标准 Markdown,易于集成到现有工作流

不足之处

  • 依赖 LLM API,可能产生费用且处理速度受限于模型调用
  • 对输入质量敏感,杂乱或低质资料可能影响生成效果

适用场景

  • 个人知识管理:将散落笔记自动整理成可检索的 Wiki
  • 团队文档沉淀:从会议记录、技术文档生成统一知识库
  • 研究资料整理:将论文、网页摘要构建为带引用的知识网络

替代项目

Obsidian、Foam、Logseq

项目介绍

llm-wiki-compiler 是搜索知识领域的开源项目,由 atomicstrata 开发,是 2026 年新上线的项目。

在全站 13,090 个收录项目中,它的 GitHub 星标数(2,100)位列前 30%,在搜索知识分类中处于中上游。

近 42 天,它的 GitHub 星标从 1,913 增加到 2,100,净增 187。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-23。MIT 许可证,可自由使用和部署,无付费版本。

它主要面向的使用场景是:个人知识管理:将散落笔记自动整理成可检索的Wiki。同类可对比的替代方案包括 Obsidian、Foam、Logseq。

上一篇:contextgem

下一篇:karpathy-llm-wiki

同类项目推荐

firecrawl 开源

网页抓取像喝水一样简单,开发者省下整周加班

The web data API to search, scrape, and interact at scale.

★ 183325 2026-08-09
contoso-chat 开源

一键跑通 Azure RAG 应用,从代码到评估部署全流程

This sample has the full End2End process of creating RAG application with Prompty an···

★ 766 2026-08-09
graphify 开源

整个代码库画成一张图,找问题一眼定位

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable k···

★ 120493 2026-08-09
ragflow 开源

让大模型用上你的私有知识,搭建可靠的企业级RAG应用

RAGFlow is a leading open-source Retrieval-Augmented Generation (RAG) engine that fu···

★ 91170 2026-08-09