Cinnamon/kotaemon项目中GraphRAG API密钥配置指南

在Cinnamon/kotaemon项目的使用过程中，GraphRAG检索功能需要正确配置API密钥才能正常工作。本文将从技术实现角度详细介绍环境变量的配置方法，帮助开发者快速完成项目设置。

环境变量配置原理

环境变量是操作系统级别的键值对存储机制，允许应用程序在不修改代码的情况下获取配置信息。在Python项目中，常见的环境变量加载方式有三种：

1. 直接通过操作系统设置
2. 使用.env文件配合python-dotenv库
3. 在命令行中临时指定

具体配置方法

基于Unix/Linux系统

对于MacOS和Linux用户，推荐以下三种配置方式：

1. 使用export命令批量加载：

export $(cat .env | xargs)
python app.py

2. 通过python-dotenv工具运行：

pip install python-dotenv
dotenv run -- python app.py

3. 命令行直接指定：

GRAPHRAG_API_KEY=your_api_key_here python app.py

Windows系统配置

Windows用户可以通过以下步骤配置：

1. 临时设置环境变量：

set GRAPHRAG_API_KEY=your_api_key_here && python app.py

2. 永久性设置（通过系统属性）：

• 打开系统属性 → 高级 → 环境变量
• 在用户变量或系统变量中添加新条目
• 变量名：GRAPHRAG_API_KEY
• 变量值：您的实际API密钥

安全注意事项

1. 切勿将包含敏感信息的.env文件提交到版本控制系统
2. 在截图或分享代码时，务必模糊处理或删除API密钥
3. 建议使用环境变量而非硬编码方式存储密钥
4. 定期轮换API密钥以提高安全性

常见问题排查

如果配置后仍无法正常工作，建议检查：

1. Python进程是否在设置环境变量后启动
2. .env文件是否位于项目根目录
3. 变量名是否完全匹配（注意大小写）
4. 是否有多余的空格或特殊字符

通过以上方法，开发者可以安全、高效地完成Cinnamon/kotaemon项目的GraphRAG功能配置，确保后续开发工作的顺利进行。