课程资料及版权来源：Datawhale Docs

GitHub - datawhalechina/camel-agent-tutorial: This is a tutorial based on the CAMEL framework, aimed at understanding how to build an Agent Society from the ground up!

学习时遇到的问题与解答（Cursor真好用！）：

一、检查python版本的时候出现问题

1. 首先，您使用的是 PowerShell (PS) 在 Windows 系统中运行命令。

2. 您尝试检查 Python 版本，使用的命令是 `python3 --version`。在 Windows 系统中，通常直接使用 `python --version` 而不是 `python3 --version`。

建议按照以下步骤操作：

1. 首先确认 Python 是否正确安装：
   ```powershell
   python --version
   ```

2. 如果上述命令不起作用，请确保：
   - Python 已经正确安装
   - Python 已添加到系统环境变量 PATH 中

3. 如果要运行 CAMEL，您需要：
   - 确保已经安装了所有必要的依赖包（通过 pip install）
   - 确保在正确的目录下运行代码
   - 确保使用正确的文件格式（.py 而不是 .ipynb，除非您使用 Jupyter Notebook）

您可以尝试以下命令来安装 CAMEL 的依赖：
```powershell
pip install -r requirements.txt
```

二、利用 pip 直接安装基础 CAMEL 库遇到问题

终端显示：

Looking in indexes: https://mirrors.cernet.edu.cn/pypi/web/simple
WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by 'SSLError(SSLEOFError(8, '[SSL: UNEXPECTED_EOF_WHILE_READING] EOF occurred in violation of protocol (_ssl.c:1000)'))': /pypi/web/simple/camel-ai/
WARNING: Retrying (Retry(total=3, connect=None, read=None, redirect=None, status=None)) after connection broken by 'SSLError(SSLEOFError(8, '[SSL: UNEXPECTED_EOF_WHILE_READING] EOF occurred in violation of protocol (_ssl.c:1000)'))': /pypi/web/simple/camel-ai/
WARNING: Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'SSLError(SSLEOFError(8, '[SSL: UNEXPECTED_EOF_WHILE_READING] EOF occurred in violation of protocol (_ssl.c:1000)'))': /pypi/web/simple/camel-ai/
WARNING: Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'SSLError(SSLEOFError(8, '[SSL: UNEXPECTED_EOF_WHILE_READING] EOF occurred in violation of protocol (_ssl.c:1000)'))': /pypi/web/simple/camel-ai/
WARNING: Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'SSLError(SSLEOFError(8, '[SSL: UNEXPECTED_EOF_WHILE_READING] EOF occurred in violation of protocol (_ssl.c:1000)'))': /pypi/web/simple/camel-ai/
Could not fetch URL https://mirrors.cernet.edu.cn/pypi/web/simple/camel-ai/: There was a problem confirming the ssl certificate: HTTPSConnectionPool(host='mirrors.cernet.edu.cn', port=443): Max retries exceeded with url: /pypi/web/simple/camel-ai/ (Caused by SSLError(SSLEOFError(8, '[SSL: UNEXPECTED_EOF_WHILE_READING] EOF occurred in violation of protocol (_ssl.c:1000)'))) - skipping
ERROR: Could not find a version that satisfies the requirement camel-ai (from versions: none)
ERROR: No matching distribution found for camel-ai

解答：

遇到了两个主要问题：

1. SSL证书验证问题
2. 镜像源连接问题（使用的是 CERNET 教育网镜像）

这个错误主要是因为：
- SSL 连接出现问题（可能是网络问题或证书验证问题）
- 可能是镜像源暂时不可用或连接不稳定

建议尝试以下解决方案：

1. 使用其他 PyPI 镜像源，比如阿里云镜像：
```powershell
pip install camel-ai -i https://mirrors.aliyun.com/pypi/simple/
```

2. 如果还是不行，可以临时禁用 SSL 验证（不推荐用于生产环境）：
```powershell
pip install --trusted-host mirrors.aliyun.com camel-ai -i https://mirrors.aliyun.com/pypi/simple/
```

3. 或者使用清华大学镜像源：
```powershell
pip install camel-ai -i https://pypi.tuna.tsinghua.edu.cn/simple
```

4. 如果以上都不行，可以尝试直接使用官方源：
```powershell
pip install camel-ai -i https://pypi.org/simple
```

如果还是遇到问题，可以：
1. 检查您的网络连接
2. 确认是否有代理或防火墙设置影响
3. 更新 pip 到最新版本：
```powershell
python -m pip install --upgrade pip
```

三、PyPI安装和源码安装的区别

两种安装方式选择一个就可以了。两种方式的区别：

1. **通过 PyPI 安装** (第一种方式)
```bash
pip install "camel-ai[all]==0.2.19"
```
- 优点：
  - 安装简单快捷
  - 适合大多数用户
  - 直接获取稳定版本
- 缺点：
  - 无法修改源代码
  - 只能使用已发布的版本

2. **通过源码安装** (第二种方式)
```bash
git clone -b v0.2.19 https://github.com/camel-ai/camel.git
cd camel
poetry install -E all
```
- 优点：
  - 可以查看和修改源代码
  - 可以参与开发
  - 可以使用最新的开发版本
- 缺点：
  - 安装步骤较多
  - 需要额外工具（git、poetry）
  - 可能遇到更多配置问题

**建议：**
- 如果只是想使用 CAMEL，建议使用第一种方式（PyPI 安装）
- 如果想研究源码或参与开发，则选择第二种方式（源码安装）

最终的功能是一样的，区别主要在于安装方式和使用场景。对于初学者来说，推荐使用第一种方式（PyPI 安装）。

四、怎么看CAMEL安装好了没

有几种方法可以检查 CAMEL 是否安装成功：

1. **使用 pip 查看**：
```bash
pip show camel-ai
```
如果安装成功，会显示版本号、安装位置等信息。

2. **使用 conda 查看**：
```bash
conda list | findstr camel
```
这会显示所有包含 "camel" 的已安装包。

3. **在 Python 中验证**：
```python
# 打开 Python 终端
python

# 然后输入
import camel
print(camel.__version__)
```

4. **查看详细包信息**：
```bash
pip list | findstr camel
```

如果看到版本号（比如 0.2.20）显示出来，就说明安装成功了。如果出现 "No module named 'camel'" 这样的错误，就说明需要重新安装。

其实后面还遇到各种配环境的问题，这个零基础根本操作不动，最后是无脑买了个cursor一步步问之后搞定的，总结就是要搞定这门课的话推荐花20刀买一个月cursor pro。