获取源代码
认知异质性实验项目是开源的,您可以通过以下方式获取源代码:
GitHub仓库
从GitHub克隆最新版本的源代码:
git clone https://github.com/ptreezh/che.git
cd che
下载ZIP包
发行版本
获取特定版本的发行包:
# 查看所有发行版本
git tag
# 获取特定版本
git checkout v1.0.0
查看所有发行版
安装步骤
方法一:使用Poetry安装(推荐)
Poetry是推荐的包管理器,可以自动处理依赖关系:
# 1. 安装Poetry(如果尚未安装)
curl -sSL https://install.python-poetry.org | python3 -
# 2. 安装项目依赖
poetry install
# 3. 激活虚拟环境
poetry shell
# 4. 验证安装
python -c "from src.che.agents.cloud_agent import CloudAgent; print('安装成功')"
方法二:使用pip安装
如果您更喜欢使用pip,可以按照以下步骤操作:
# 1. 创建虚拟环境
python -m venv che-env
# 2. 激活虚拟环境
# Windows:
che-env\Scripts\activate
# macOS/Linux:
source che-env/bin/activate
# 3. 安装依赖
pip install -r requirements.txt
# 4. 验证安装
python test_cloud_agent_import.py
云服务配置
为了使用CloudAgent功能,您需要配置相应的云服务API密钥:
创建配置文件
# 复制示例配置文件
cp .env.example .env
# 编辑配置文件
nano .env # 或使用您喜欢的编辑器
配置API密钥
在.env文件中添加您的API密钥:
# OpenAI API密钥
OPENAI_API_KEY=your-openai-api-key
# Azure OpenAI服务
AZURE_API_KEY=your-azure-api-key
AZURE_ENDPOINT=your-azure-endpoint
# 阿里云DashScope
ALIYUN_API_KEY=your-aliyun-api-key
# 腾讯云HunYuan
TENCENT_API_KEY=your-tencent-api-key
# 百度云文心一言
BAIDU_API_KEY=your-baidu-api-key
BAIDU_SECRET_KEY=your-baidu-secret-key
本地模型支持
如果您希望使用本地模型,可以安装Ollama:
安装Ollama
macOS
使用Homebrew安装:
brew install ollama
Linux
使用curl安装:
curl -fsSL https://ollama.com/install.sh | sh
拉取模型
安装完成后,拉取所需的模型:
# 拉取Qwen模型
ollama pull qwen:0.5b
ollama pull qwen:1.8b
ollama pull qwen2:1.5b
# 拉取Gemma模型
ollama pull gemma:2b
ollama pull gemma2:2b
# 查看所有可用模型
ollama list
验证安装
完成安装后,运行以下命令验证安装是否成功:
# 1. 检查Python版本
python --version
# 2. 检查依赖安装
poetry show # 或 pip list
# 3. 运行简单测试
python -c "import sys; sys.path.append('.'); from src.che.agents.cloud_agent import CloudAgent; print('CloudAgent导入成功')"
# 4. 运行完整测试
python test_agent_factory.py
如果所有测试都通过,说明安装成功!