开源 Karpathy's LLM Wiki 的开源实现

LLM Wiki

AI驱动的知识库构建系统

上传原始文档，连接 Claude，让 AI 自动构建、维护和交叉引用你的维基知识库。 基于 MCP 协议，实现三层架构的智能知识管理。

🌐 访问在线版本 📖 查看源代码

Next.js 前端

Web 界面

→

FastAPI 后端

API 服务

→

Supabase

数据库存储

↔

MCP Server

Claude 连接

三层架构设计

LLM Wiki 采用创新的三层架构理念，确保数据完整性、可维护性和智能交互

📁

Raw Sources

原始资料层

不可变的真实来源，LLM 只读不改，确保数据可信度和溯源能力。

  • PDF 文档
  • 转录文件
  • 笔记记录
  • Office 文档
📝

The Wiki

维基知识层

LLM 生成的 Markdown 页面，包含摘要、实体页、可视化图表。

  • 智能摘要
  • 实体页面
  • Mermaid 图表
  • 交叉引用
🔧

The Tools

MCP 工具层

通过 MCP 接口，让 Claude 能够搜索、读取、写入其他两层内容。

  • search - 搜索内容
  • read - 读取文件
  • write - 写入维基
  • delete - 删除页面

四大服务组件

模块化设计，每个组件独立部署，灵活扩展

🌐

Web 前端

web/

Next.js 16 前端应用，提供仪表板界面、文档查看器、维基渲染引擎。

Next.js 16 React 19 Tailwind Radix UI
⚡

API 后端

api/

FastAPI 后端服务，处理认证、可恢复上传(TUS)、文档处理管道。

FastAPI asyncpg aioboto3 Python 3.11+
🔗

MCP Server

mcp/

模型上下文协议服务器，向 Claude 暴露搜索、读取、写入工具，支持 Supabase OAuth。

MCP SDK Supabase OAuth Claude API
🔄

Converter

converter/

隔离微服务，使用 LibreOffice 将 Office 文档转换为 PDF，确保安全处理。

LibreOffice Docker Mistral OCR
guide
search
read
write
delete

技术栈

采用现代化技术栈，确保高性能、可扩展性和开发效率

React 19

最新前端框架

TypeScript

类型安全开发

FastAPI

高性能 Python API

PostgreSQL

PGroonga 全文搜索

Supabase

BaaS + RLS 安全

S3 Storage

可扩展文件存储

Claude API

Anthropic AI

MCP Protocol

模型上下文协议

核心特性

强大的功能，让知识管理变得智能且高效

📄

多格式支持

支持 PDF、Office 文档、笔记、转录等多种格式上传

🧠

AI 自动生成

Claude 自动读取源文件并生成维基页面

🔗

交叉引用

自动维护页面间的引用关系和溯源链接

🔍

全文搜索

PGroonga 全文搜索，快速定位知识内容

🔒

安全隔离

Supabase RLS 行级安全，文档转换隔离处理

📊

可视化图表

Mermaid 图表自动生成，直观展示关系

🚀

可恢复上传

TUS 协议支持大文件分片上传和断点续传

🌐

自托管支持

完全开源，可本地部署或使用托管版本

🤖

MCP 集成

通过 MCP 协议连接 Claude，智能交互

1

上传文档

上传 PDF、Office 等源文件

2

连接 Claude

通过 MCP 连接 Claude 账户

3

AI 处理

Claude 自动分析和生成

4

维基构建

自动生成交叉引用的维基

快速开始

两种方式开始使用 LLM Wiki

🌐 托管版本

访问 llmwiki.app，无需部署，立即开始使用。适合快速体验和个人使用。

🔧 自托管版本

克隆源码，本地部署。适合团队使用、定制开发和数据隐私要求。

本地部署步骤

# 1. 克隆项目
git clone https://github.com/lucasastorian/llmwiki.git
cd llmwiki

# 2. 安装依赖
pnpm install

# 3. 配置环境变量
cp .env.example .env

# 4. 启动服务
pnpm dev

环境要求：Python 3.11+、Node.js 20+、Supabase 项目、S3 存储配置