免费开源
📊 办公自动化
免费开源
Khoj 个人AI知识库助手
Khoj 是一款面向个人知识管理的 AI 助手，支持本地文件索引、笔记搜索、文档对话等功能，可与 Obsidian、Notion 等笔记工具集成，帮助用户快速检索和利用个人知识库中的信息。
⭐ Star37161
🍴 Fork2461
👁 浏览456
📅 更新2026-09-07
📜 协议GNU Affero General Public License v3.0
🎯 核心功能
- 智能对话交互
- 任务规划与分解
- 工具调用能力
- 多轮对话记忆
- 可扩展插件系统
🚀 部署教程
# khoj khoj - AI agent proj 部署教程
## 环境要求
- Python 3.9+ / Node.js 18+
- 大模型 API Key（OpenAI / DeepSeek / 通义千问等）
## 快速开始
```bash
git clone https://github.com/khoj-ai/khoj
cd khoj khoj - AI agent proj
pip install -r requirements.txt
# 或 npm install
```
## 配置
复制 .env.example 为 .env，填入大模型 API Key 和相关配置。
## 启动
```bash
python main.py
# 或 npm start
```
## 更多信息
访问项目主页获取完整文档：https://github.com/khoj-ai/khoj
⚠️ 常见报错与解决方案
## 常见报错及解决方案
### 1. API Key 未配置
**报错**: API key not found / Authentication failed
**解决**: 在 .env 文件中正确配置大模型 API Key
### 2. 依赖安装失败
**报错**: ModuleNotFoundError / No module named 'xxx'
**解决**: 确认 Python 版本，执行 pip install -r requirements.txt
### 3. 端口被占用
**报错**: Address already in use / Port 8000 already in use
**解决**: 修改配置文件中的端口号，或关闭占用端口的进程
### 4. 模型调用超时
**报错**: Timeout / Request timed out
**解决**: 检查网络连接，增加超时时间，或更换 API 端点
### 5. 内存不足
**报错**: Out of memory / Killed
**解决**: 减少并发数，使用更小的模型，或增加服务器内存
💬 问题留言 （9条）