准备工作：你需要装什么

在开始之前，先确认你的电脑上安装了 Python（一种编程语言，用来写和运行 AI 程序）。如果还没装：

• 去 python.org 下载最新版（建议 3.8 以上）。
• 安装时记得勾选“Add Python to PATH”（否则后面会报找不到命令）。

然后安装 Git（一个下载代码的工具）：

• 去 git-scm.com 下载安装包，一路默认即可。

安装步骤：克隆项目并配置环境

1. 打开终端（Windows 按 Win+R 输入 cmd，Mac 打开“终端”）。
2. 输入命令下载 SoulForge 项目：git clone https://github.com/zhangshu-No1/SoulForge.git
3. 进入项目文件夹：cd SoulForge
4. 创建虚拟环境（隔离依赖，避免冲突）：python -m venv venv
5. 激活虚拟环境：Windows 输入 venv\Scripts\activate，Mac/Linux 输入 source venv/bin/activate。
6. 安装依赖：pip install -r requirements.txt（如果很慢，可以加 -i https://pypi.tuna.tsinghua.edu.cn/simple 用国内镜像）。

验证是否成功：运行你的第一个 AI

确保虚拟环境已激活，然后输入：

• python main.py

如果看到类似“AI 已启动，请输入你的名字”这样的提示，就说明成功了！你可以试着跟它聊天，它会记住你说过的话。常见错误：

• 报错“No module named xxx”：说明依赖没装全，重新运行 pip install -r requirements.txt。
• 报错“Python not found”：检查 Python 是否安装并添加到了 PATH。

下一步可以做什么

现在你已经跑通了一个 AI 项目，可以尝试：

• 修改 config.py 里的参数，改变 AI 的性格。
• 给它添加更多记忆，让它更懂你。
• 去 GitHub 上看看项目的文档，了解更多高级功能。