下载安装

获取并安装认知异质性实验软件

← 返回首页

系统要求

操作系统

  • Windows 10/11
  • macOS 10.15或更高版本
  • Linux (Ubuntu 20.04+推荐)

软件依赖

  • Python 3.9或更高版本
  • Git版本控制工具
  • Poetry包管理器

硬件要求

  • 内存:至少8GB RAM
  • 存储:至少5GB可用空间
  • 网络:稳定的互联网连接

获取源代码

认知异质性实验项目是开源的,您可以通过以下方式获取源代码:

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

Windows

从Ollama官网下载Windows安装包:

下载Windows版

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

如果所有测试都通过,说明安装成功!