git clone github.com/ximyma/sowo... Sowork AI Agent 是一个编程助手，集成了最新的AI Code技术框架，和openclaw、Hermes等自进化的智能体框架。
Python环境搭建与Sowork项目克隆
学习目标
- 在 Windows / macOS / Linux 上安装 Python 3.10+
- 安装并配置 Git
- 克隆 Sowork 项目到本地
- 初步了解项目目录结构
核心概念
Python 版本选择
Sowork 项目要求 Python 3.10+ ，原因有三：
match/case模式匹配（3.10新特性）在配置解析中大量使用X | None联合类型简写语法（3.10+）asyncio的稳定性改进
为什么要装 Python 3.10+ 而不是 3.8？
Python 3.8 将在 2024 年 10 月停止维护。Sowork 作为 AI Agent 框架，使用了大量 3.10+ 新特性------包括 match/case、| 联合类型、asyncio.TaskGroup（3.11+）等。用低版本运行会直接报语法错误。
安装步骤
Windows 安装 Python
shell
powershell
复制
# 1. 访问 https://www.python.org/downloads/ 下载 3.10+ 安装包
# 2. 双击安装，务必勾选 ✅ "Add Python to PATH"
# 3. 验证安装
python --version
# Python 3.10.13
# 如果 python 命令无效，尝试
py --versionmacOS 安装 Python
perl
bash
复制
# 方式一：官网下载 .pkg 安装包（推荐）
# https://www.python.org/downloads/
# 方式二：Homebrew
brew install python@3.12
# 验证
python3 --version
# Python 3.12.2Linux (Ubuntu/Debian) 安装 Python
bash
bash
复制
# Ubuntu 22.04+ 自带 Python 3.10
python3 --version
# 如果没有或版本太低
sudo apt update
sudo apt install python3.12 python3.12-venv python3.12-devGit 安装与配置
php
bash
复制
# Windows: 下载 https://git-scm.com/download/win
# macOS: brew install git
# Linux: sudo apt install git
# 配置用户信息（必须，否则无法提交）
git config --global user.name "你的名字"
git config --global user.email "your@email.com"
# 验证
git --version
# git version 2.43.0Sowork实战代码
克隆 Sowork 项目
bash
bash
复制
# 从 GitHub 克隆
git clone https://github.com/ximyma/sowork
cd sowork
# 查看项目结构（第一印象）
ls -la项目目录结构初览
克隆完成后，你会看到如下结构：
bash
复制
sowork/
├── README.md # 项目说明文档
├── LICENSE # 开源许可证
├── requirements.txt # Python 依赖清单
├── pyproject.toml # 现代化项目配置（入口点、元数据）
├── system_init.py # 🔑 初始化脚本（首次运行必执行）
├── launch.py # 🚀 总启动脚本（前后端联动）
├── cow # 🐄 CLI 命令入口（无需 python 前缀）
│
├── src/ # 核心源代码
│ ├── __init__.py
│ ├── agent/ # Agent 引擎（LLM调用、工具执行）
│ ├── tools/ # 76+ 工具实现
│ ├── memory/ # 5层记忆系统
│ ├── models/ # 数据模型（Pydantic / dataclass）
│ ├── gateway/ # 统一网关（路由分发）
│ ├── config/ # 配置管理
│ │ ├── settings.py # 全局配置类
│ │ └── models_config.py # 17+ LLM 模型配置
│ ├── server/ # 后端 API 服务
│ └── utils/ # 工具函数
│
├── frontend/ # React 前端（Vite）
│ ├── src/
│ │ ├── components/ # UI 组件
│ │ ├── pages/ # 页面
│ │ └── App.tsx
│ ├── package.json
│ └── vite.config.ts
│
├── admin/ # 管理后台
│ └── admin_server.py # 独立 Web 管理面板
│
├── data/ # 运行时数据（首次运行后生成）
│ ├── config.json # 用户配置文件
│ ├── sowork.db # SQLite 数据库
│ └── memory/ # 记忆存储目录
│
└── logs/ # 日志文件快速验证环境
scss
python
复制
# 在 sowork 目录下运行
python -c "
import sys
print(f'Python {sys.version}')
required = (3, 10)
current = sys.version_info[:2]
if current >= required:
print('✅ 版本符合 Sowork 要求')
else:
print(f'❌ 需要 Python 3.10+，当前 {current[0]}.{current[1]}')
"运行演示
bash
bash
复制
# === 完整的环境搭建流程 ===
# Step 1: 检查 Python
python --version
# Python 3.12.2 ✅
# Step 2: 检查 Git
git --version
# git version 2.43.0 ✅
# Step 3: 克隆项目
git clone https://github.com/ximyma/sowork
cd sowork
# Step 4: 查看目录
ls
# cow launch.py README.md requirements.txt src/ system_init.py ...
# Step 5: 创建虚拟环境（下一篇详解）
python -m venv venv
source venv/bin/activate # macOS/Linux
# venv\Scripts\activate # Windows
# Step 6: 安装依赖
pip install -r requirements.txt
# Step 7: 初始化
python system_init.py
# 🚀 Sowork 初始化完成！
# ✅ 目录结构已创建
# ✅ 默认配置已生成
# ✅ 数据库已初始化
# Step 8: 启动
python launch.py
# 🔧 后端服务: http://localhost:16888
# 🌐 前端界面: http://localhost:5173
# 📊 管理后台: http://localhost:16889注意事项
- 不要用系统自带 Python：macOS 自带 Python 2.7（已废弃），务必安装 Python 3
- PATH 配置：Windows 用户安装时一定要勾选 "Add Python to PATH"
- Python 命令差异 ：Windows 用
python，macOS/Linux 可能用python3，统一用python3 -m venv最安全 - Git 大文件 ：如果克隆很慢，可以用
git clone --depth=1浅克隆 - 不要跳过 system_init.py：首次运行必须执行，否则缺少配置文件
练习
- 在你的操作系统上安装 Python 3.10+，截图记录
python --version输出 - 克隆 Sowork 项目，用
tree -L 2（或ls -R | head -50）查看目录结构 - 找出
system_init.py、launch.py、cow三个文件，阅读前 30 行代码，猜测它们的作用 - 打开
requirements.txt，数一数有多少个依赖包，认识前 5 个包名