OpenKB

上传文档，让 LLM 秒变领域专家

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署搜索知识 🍴 复刻 504 🐛 待处理 90 👀 关注 13

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 4861

维护状态低维护

是否开源开源

定价模式 🏷️完全免费开源项目，Apache-2.0 许可证，可免费使用和部署。

项目预览

项目数据

分类搜索知识

开发团队VectifyAI

官网地址https://pageindex.ai

GitHubhttps://github.com/VectifyAI/OpenKB

定价模式🏷️完全免费

价格说明开源项目，Apache-2.0 许可证，可免费使用和部署。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议Apache-2.0

主要语言Python

技术栈/模型agents,ai,knowledge-base,llm,rag,retrieval

GitHub 星标★ 4861

上线时间2026-04-04 00:00:00

代码更新2026-07-22

仓库体积32.7 MB

本站数据更新2026-11-09

维护状态低维护

收录时间2026-08-09

浏览次数2

项目介绍

OpenKB 是一个面向大语言模型（LLM）的开源知识库系统，旨在解决 LLM 在专业领域知识不足、回答不准确的问题。它允许用户将私有文档（如 PDF、Markdown 等）上传并构建索引，通过检索增强生成（RAG）方式为 LLM 提供外部知识支撑。核心能力包括：支持多种文档格式解析、智能分块与向量化存储、混合检索（关键词+向量）、与主流 LLM API 无缝集成、提供友好的 Web 界面用于知识库管理和问答测试。项目基于 Python 构建，部署简单，适合个人开发者和小团队快速搭建私有知识问答系统。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 4861

技术标签

agents ai knowledge-base llm rag

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

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

环境要求

Python 环境及 pip（用于 pip install openkb）
一个 LLM 提供商的 API Key（如 OpenAI、Claude、Gemini）
可选：PageIndex Cloud 的 PAGEINDEX_API_KEY（处理扫描版或大型 PDF 时使用）
项目根目录下可写 .env 与 .openkb/config.yaml 的权限

安装与启动步骤

1安装 OpenKB

README 推荐的最简安装方式，直接通过 pip 从 PyPI 安装 OpenKB 命令行工具。
```
pip install openkb
```
2可选：安装 GitHub 最新版

想用最新代码时可用此方式从 GitHub 仓库直接安装，替代上面的 PyPI 安装。
```
pip install git+https://github.com/VectifyAI/OpenKB.git
```
3可选：源码可编辑安装

开发调试场景，克隆仓库后以可编辑模式安装，便于修改源码。
```
git clone https://github.com/VectifyAI/OpenKB.git
cd OpenKB
pip install -e .
```
4写入 LLM API Key

在项目目录创建 .env 文件并填入你的 LLM 密钥；使用 OAuth 设备流登录的提供商（chatgpt/*、github_copilot/*）无需填写。
```
LLM_API_KEY=your_llm_api_key
```
5初始化知识库

运行初始化命令，过程中按提示选择模型，格式为 provider/model（如 anthropic/claude-sonnet-4-6），OpenAI 模型可省略前缀。
```
openkb init
```
6按需启用 PageIndex 云服务

默认使用本地开源版 PageIndex；若需 OCR、更快索引或大规模文档处理，在 .env 中补充 PAGEINDEX_API_KEY。
```
PAGEINDEX_API_KEY=your_pageindex_api_key
```

关键配置

配置项	必填	说明	示例
`LLM_API_KEY`	是	LLM 提供商的 API 密钥，供 LiteLLM 调用模型使用	`your_llm_api_key`
`PAGEINDEX_API_KEY`	否	启用 PageIndex Cloud，获得扫描件 OCR、更快结构与大规模索引	`your_pageindex_api_key`
`model（.openkb/config.yaml）`	是	指定使用的模型，LiteLLM 的 provider/model 格式，OpenAI 可省前缀	`anthropic/claude-sonnet-4-6`