5分钟搭建个人AI知识库：Khoj从安装到智能问答全攻略

【免费下载链接】khoj An AI copilot for your second brain. Search and chat with your personal knowledge base, online or offline 项目地址: https://gitcode.com/GitHub_Trending/kh/khoj

你是否曾在海量笔记中艰难搜索某个观点？是否希望有个AI助手能理解你的知识库并即时解答问题？Khoj作为你的"第二大脑AI副驾"，让这一切成为现实。本文将带你在5分钟内完成从安装到使用的全流程，无需编程经验，轻松拥有私人AI知识库。

为什么选择Khoj构建个人知识库？

Khoj是一款开源的个人AI助手，专为管理和交互个人知识库设计。它能让你：

• 离线/在线搜索和聊天你的私人知识库
• 支持多种客户端（浏览器、Obsidian、Emacs、桌面应用等）
• 处理多种文件格式（PDF、Markdown、Word、图片等）
• 支持本地部署，确保数据隐私安全

系统准备与环境要求

在开始前，请确保你的系统满足以下基本要求：

• 操作系统：Windows 10/11、macOS 12+或Linux（Ubuntu 20.04+推荐）
• 硬件配置：
  • 最低：4GB RAM，5GB可用磁盘空间
  • 推荐：8GB RAM（本地AI模型运行需要）
  • 可选：GPU加速（NVIDIA/AMD显卡或Apple M1+芯片）
• 软件依赖：
  • Docker（推荐）或Python 3.9+环境

官方文档：Khoj安装指南

快速安装：两种方式任选

Docker安装（推荐新手）

Docker方式安装最为简便，适合大多数用户：

1. 首先安装Docker Desktop：

   • Windows用户：Docker Desktop Windows版
   • Mac用户：Docker Desktop Mac版
   • Linux用户：Docker Desktop Linux版

2. 打开终端，执行以下命令：

mkdir ~/.khoj && cd ~/.khoj
wget https://raw.githubusercontent.com/khoj-ai/khoj/master/docker-compose.yml

3. 配置环境变量（可选但推荐）： 编辑下载的docker-compose.yml文件，设置管理员密码和API密钥：

   environment:
     - KHOJ_ADMIN_PASSWORD=your_secure_password
     - KHOJ_DJANGO_SECRET_KEY=your_secure_secret_key
     # 可选：添加OpenAI等API密钥
     # - OPENAI_API_KEY=your_openai_api_key
   

4. 启动Khoj服务：

docker-compose up

当看到终端显示🌖 Khoj is ready to engage时，表示服务已成功启动。

Python Pip安装（适合开发者）

如果你熟悉Python环境，可以通过pip直接安装：

# MacOS ARM/M1+用户
CMAKE_ARGS="-DGGML_METAL=on" python -m pip install 'khoj[local]'

# Windows用户
py -m pip install 'khoj[local]'

# Linux用户
python -m pip install 'khoj[local]'

安装完成后启动服务：

USE_EMBEDDED_DB="true" khoj --anonymous-mode

访问与配置Khoj

登录Web界面

服务启动后，打开浏览器访问：http://localhost:42110

首次访问时，系统会引导你完成初始设置：

1. 创建管理员账户（邮箱和密码）
2. 选择聊天模型（可使用本地模型或API服务）
3. 配置知识库来源

配置聊天模型

Khoj支持多种AI模型，包括在线和本地模型：

1. 登录管理员面板：http://localhost:42110/server/admin
2. 添加AI模型API配置：
   • 在线模型：OpenAI、Anthropic、Gemini等
   • 本地模型：Ollama、LM Studio等（完全离线，保护隐私）

3. 创建聊天模型实例：
   • 设置模型名称（如gpt-4o、claude-3-5-sonnet等）
   • 选择模型类型和对应的API配置
   • 根据需要启用视觉功能（仅部分模型支持）

添加知识库内容

Khoj支持多种方式添加和同步知识库内容：

直接上传文件

最简单的方式是通过Web界面直接上传文件：

1. 访问Khoj Web界面：http://localhost:42110
2. 点击"上传文件"按钮
3. 选择要添加的文件（支持PDF、Markdown、Word、图片等格式）

配置自动同步

对于常用的笔记工具，可设置自动同步：

• Obsidian用户：安装Khoj插件 Obsidian插件源码

• Emacs用户：安装Khoj Emacs包 Emacs插件源码

• Notion用户：通过集成功能连接Notion工作区 Notion集成文档

开始使用智能问答功能

基本搜索与问答

1. 在Web界面的搜索框中输入问题或关键词
2. 查看搜索结果并进行上下文对话
3. 使用筛选器按文件类型、日期等缩小搜索范围

高级使用技巧

• 精确搜索：使用引号包裹精确短语，如"人工智能发展历程"
• 排除关键词：使用减号排除特定内容，如"机器学习 -深度学习"
• 文件类型筛选：使用file:pdf或file:md指定文件类型
• 日期范围筛选：使用date:2023-2024限定时间范围

搜索功能实现源码：搜索模块

多客户端使用体验

Khoj提供多种客户端，满足不同场景需求：

桌面客户端

适合日常使用，支持全局快捷键调用：

1. 下载桌面客户端：桌面应用源码
2. 安装后登录你的Khoj服务
3. 使用默认快捷键Ctrl+Shift+K(Windows/Linux)或Cmd+Shift+K(Mac)快速打开

移动体验

通过PWA功能将Khoj添加到手机主屏幕：

1. 在移动浏览器中访问Khoj Web界面
2. 点击"添加到主屏幕"
3. 完成安装后即可像原生应用一样使用

常见问题解决

服务无法启动怎么办？

1. 检查Docker/Python环境是否正常运行
2. 查看日志文件定位错误原因
3. 尝试删除~/.khoj目录后重新安装

如何确保数据安全？

• 使用本地部署模式，所有数据存储在本地
• 定期备份~/.khoj目录
• 敏感内容可使用加密笔记后再添加到知识库

本地模型运行缓慢？

• 确保已配置GPU加速
• 尝试更小的模型（如7B参数模型）
• 增加系统内存或调整Docker资源限制

故障排除详情：Khoj故障排除指南

总结与进阶学习

恭喜！你已成功搭建并开始使用Khoj个人AI知识库。通过本文你已掌握：

• 快速安装Khoj的两种方法
• 基础配置与模型设置
• 添加和管理知识库内容
• 使用多客户端进行交互

进阶学习资源：

• 创建自定义AI代理：Khoj Agents文档
• 自动化工作流：Khoj Automations指南
• 贡献代码：开发者文档

现在，开始向你的Khoj知识库添加内容，体验AI驱动的个人知识管理新方式吧！如有任何问题，欢迎加入Khoj社区寻求帮助。

提示：定期更新Khoj以获取最新功能和改进。使用docker-compose up --build(Docker)或pip install --upgrade khoj(Pip)进行升级。

【免费下载链接】khoj An AI copilot for your second brain. Search and chat with your personal knowledge base, online or offline 项目地址: https://gitcode.com/GitHub_Trending/kh/khoj