Kotaemon项目本地开发环境搭建指南（M1 Mac版）

Kotaemon是一个基于Python开发的AI应用框架，本文专门针对M1芯片的MacBook Pro用户，详细介绍如何搭建本地开发环境并运行该项目。

环境准备

在开始之前，请确保您的系统满足以下要求：

• MacBook Pro配备M1芯片
• 已安装Homebrew包管理器
• Python 3.x环境
• Git版本控制工具

详细安装步骤

1. 克隆项目代码库

首先需要获取项目源代码：

git clone https://github.com/Cinnamon/kotaemon
cd kotaemon

2. 创建Python虚拟环境

为项目创建独立的Python虚拟环境：

python -m venv kotaemon-env
source kotaemon-env/bin/activate

3. 解决依赖问题

项目依赖的unstructured包需要特定版本，需手动修改配置文件：

1. 编辑libs/kotaemon/pyproject.toml文件
2. 在依赖项列表中添加unstructured==0.15.8

4. 安装系统依赖

通过Homebrew安装必要的系统库：

brew install libmagic

5. 配置NLTK数据

项目需要NLTK的语言模型数据，需手动下载：

import nltk
nltk.download('averaged_perceptron_tagger')

6. 安装Python依赖

安装项目核心组件及其所有依赖：

pip install -e "libs/kotaemon[all]"
pip install -e "libs/ktem"

运行与配置

启动应用程序

完成安装后，可直接运行：

python app.py

API密钥配置

重要提示：API密钥应通过应用程序界面设置，而非直接修改.env文件。在应用启动后：

1. 访问本地服务
2. 导航至设置页面
3. 分别为LLM资源和嵌入资源配置相应的API密钥

常见问题解决

1. Docker兼容性问题：M1芯片用户不建议使用提供的Docker镜像，因其针对amd64架构且版本较旧。

2. 环境隔离：项目推荐使用conda环境而非venv，主要出于以下考虑：

   • 保持安装的独立性
   • 避免干扰用户现有环境
   • 便于非技术用户管理

3. 模型支持：项目支持多种本地模型运行方式，包括Hugging Face模型和Ollama等。

结语

通过上述步骤，开发者可以在M1 Mac设备上成功搭建Kotaemon项目的本地开发环境。项目团队欢迎开发者贡献代码，特别是完善安装脚本和文档部分，以提升项目的易用性。对于更深入的功能开发和使用，建议参考项目文档中的本地模型配置指南。