OpenKB 是什么?

OpenKB v0.4.5 是 Python CLI:把文件和网页编译为带摘要、概念、实体与链接的 Markdown Wiki,再从 Wiki 提供查询、对话、Skill 和演示文稿生成。

⭐ 2,446 Stars 🍴 272 Forks Python Apache-2.0 作者: VectifyAI
来源:github.com/VectifyAI/OpenKB/tree/v0.4.5 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

最新正式版 v0.4.5 发布于 2026-07-20,是兼容性热修复并固定 openai==2.44.0。OpenKB v0.4.5 是 Python CLI:把文件和网页编译为带摘要、概念、实体与链接的 Markdown Wiki,再从 Wiki 提供查询、对话、Skill 和演示文稿生成。

来源:github.com/VectifyAI/OpenKB

核心功能

可审阅的 Wiki 编译

把 PDF、Word、Markdown、PowerPoint、HTML、Excel、CSV、文本和 URL 转成 sources、summaries、concepts、entities 与交叉链接。

来源:github.com/VectifyAI/OpenKB/tree/v0.4.5
长文档 PageIndex

短文档全文读取;达到默认 20 页阈值的 PDF 使用分层树索引,本地 PageIndex 是默认路径。

来源:github.com/VectifyAI/OpenKB/tree/v0.4.5
Skill Factory

从 Wiki 生成可移植 Skill,并提供 validate、eval、history 和 rollback。

来源:github.com/VectifyAI/OpenKB/tree/v0.4.5

技术架构

转换器先把短资料转成 Markdown,把长 PDF 转成 PageIndex 树;LLM 编译 Wiki 后,query/chat/skill/deck 等生成器从同一知识层读取。

来源:github.com/VectifyAI/OpenKB/tree/v0.4.5

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) openkb==0.4.5 openai==2.44.0 litellm==1.87.2 pageindex==0.3.0.dev3pageindex==0.3… 可审阅的 Wiki 编译 长文档 PageIndex Skill Factory OpenKB 项目本体 核心功能 关键依赖

技术栈

语言Python 3.10+框架CLI + LiteLLM + PageIndex + 可选 FastAPI Web UI
openkb==0.4.5openai==2.44.0litellm==1.87.2pageindex==0.3.0.dev3
.openkb/config.yaml、.env、wiki/;Web 默认 127.0.0.1:7566
来源:github.com/VectifyAI/OpenKB/blob/v0.4.5/pyproject.toml

快速上手

路径一:虚拟环境中固定安装 openkb==0.4.5,执行 init、add、query、status、list、lint。路径二:检出 v0.4.5 后 pip install -e .;若用网页界面则安装 openkb[web] 并运行 openkb-web。
来源:github.com/VectifyAI/OpenKB/tree/v0.4.5

使用场景

适合把获准的长报告、手册和论文编译成能浏览、引用、版本控制的知识库,或由此生成 Agent Skill。只问一份短文件、需要完全自定义检索管线或不允许调用外部模型时,应另行评估。

来源:github.com/VectifyAI/OpenKB/tree/v0.4.5;https://github.com/run-llama/…

优势与局限

优势

  • Markdown Wiki 可直接审阅和版本控制
  • 长 PDF 有本地 PageIndex 路径
  • 生成 Skill 带验证、评测和回滚命令

局限

  • 仍依赖所选 LLM 的费用、上下文和数据政策
  • PageIndex Cloud 会增加外部数据边界
  • 生成内容的正确率需用真实资料验证
来源:github.com/VectifyAI/OpenKB/tree/v0.4.5

最新版本

最新正式版 v0.4.5 发布于 2026-07-20,是兼容性热修复并固定 openai==2.44.0。

来源:github.com/VectifyAI/OpenKB/releases/tag/v0.4.5

实测与证据

status: official_docs_checked_not_installed  |  checked_at: 2026-09-23  |  environment: 静态核对 v0.4.5 release、README、pyproject、配置与安全说明  |  limitations: 未安装依赖、导入真实文档、调用模型或测量准确率  |  observed_output: 官方文档确认 Python 3.10+、两条安装路径、PageIndex 默认本地、Web 默认 127.0.0.1:7566 以及 status/list/lint/skill 验证命令

来源:github.com/VectifyAI/OpenKB/releases/tag/v0.4.5

同类项目对比

LlamaIndex 是提供连接器、索引、检索器和工作流的应用开发框架;OpenKB 的边界是把资料编译成可审阅的 Markdown Wiki,并直接提供查询、Skill 和 deck。前者适合自定义应用管线,后者适合维护成品知识库。

来源:github.com/run-llama/llama_index;https://github.com/VectifyAI/OpenKB/…

总结评价

有持续搜索需求,且官方资料足以写成可执行教程。采用前先决定 LLM 与 PageIndex 是否允许接触资料,再用直接事实、跨文档关系和拒答问题做回归验证。

来源:github.com/VectifyAI/OpenKB/tree/v0.4.5

常见问题

OpenKB v0.4.5 最少需要什么环境?

官方 pyproject 要求 Python 3.10 或更高版本。基础 CLI 可用 pip install openkb;网页界面需另装 openkb[web]。处理资料还需要可用的 LLM 提供商,本地 PageIndex 是默认路径。

OpenKB 会把 PDF 发到云端吗?

本地 PageIndex 默认不需要外部 PageIndex 服务。只有配置 PAGEINDEX_API_KEY 并选择云端能力时,文档或页面数据才会交给 PageIndex Cloud;LLM 提供商仍有自己的数据处理边界。

OpenKB 网页界面能直接暴露到公网吗?

不应直接暴露。openkb-web 默认监听 127.0.0.1:7566,且本地认证默认关闭;若改变监听地址,先设置 OPENKB_API_TOKEN,并在反向代理层补上 TLS 和访问控制。

OpenKB v0.4.5 升级时要注意什么?

先备份 .openkb、wiki 和 skills,再固定安装 openkb==0.4.5。该版本为兼容性热修复并固定 openai==2.44.0;升级后运行 openkb status、openkb list 和 openkb lint,确认旧库仍可读。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件