love530love的博客

Docker Compose 拉取 redis:7-alpine 镜像失败处理：failed to resolve reference "docker.io/library/redis:7-alpine": failed to do request: Head

开源 AI Agent 项目 V1 版本 [新版] 部署 日志

基于《Python 多版本与开发环境治理架构设计》的实践记录

使用命令行创建SUNA 项目本地的 Poetry 虚拟环境实战演示 —— 基于《Python 多版本与开发环境治理架构设计》

温馨提示：本次笔记记录的比较详尽，请结合目录查看，谢谢！ 代码输出对照： 1、系统版本： 说明：Windows 10 预览版（Build 27871），需确保 Docker Desktop 启用 WSL 2 后端。 2、虚拟环境： 说明：通过创建的 Python 3.12 隔离环境，避免依赖冲突。 3、执行命令： 说明：启动管理员模式安装脚本，允许修改系统配置文件。 用户操作按回车键继续

隔离层级载体隔离对象核心作用第一层Anaconda 虚拟环境python312系统 Python统一团队的基础 Python 版本，避免系统环境干扰。第二层项目.venv项目依赖隔离不同项目的依赖包，避免版本冲突（如 Project A 的 Django 3.0 和 Project B 的 Django 4.0）。第三层项目.venv内的 Poetry依赖管理工具确保poetry命令的行为完全由项目环境决定，与系统级 Poetry 的版本 / 配置无关。通过这三层隔离，项目实现了。

【代码】【笔记】AI Agent 项目 SUNA 部署 之 Docker 构建记录。

新方案通过环境变量使得系统能够识别 MSYS2 提供的 GTK 动态库，从而不再强制使用 MSYS2 的 Python。结合 Poetry 虚拟环境，可以灵活选择 Python 版本并快速进行依赖管理，更加适合现代 Python 开发者在 Windows 上开发和部署基于 GTK 的前端应用。强烈推荐开发者使用此方案，尤其适用于部署 AI Agent 项目 SUNA、需要在 Windows 上同时完成前后端运行测试的场景。

工作记录。

在 Python 开发中，为不同项目配置独立且适配的虚拟环境至关重要。结合 Conda 和 Poetry 工具，能高效创建不同 Python 版本的 Poetry 虚拟环境，接下来将详细阐述其完整流程及逻辑关联。

工作记录【PyCharm使用基础】当遇到虚拟环境难以修复的场景，我们需要删除当前解释器和虚拟环境然后再重新创建虚拟环境，以下是在PyCharm中正确移除的步骤。

工作记录。

工作记录。

采用升级 MSYS2 Python 版本或下载安装旧版 Python 的方案，而是。关于SUNA在Windows系统下的Poetry环境部署我们最终。，并确保 Python 头文件和库正确安装，成功解决了所有问题。，并确保 Rust 工具链匹配 Python 的库格式。，不包含任何 Python 版本升级或更换方案，仅记录。，并且它已经正确编译并安装到 Poetry 虚拟环境中。，Rust 的 GNU 工具链可以正确链接。现在可以继续项目开发了！，解决 Poetry 下载。，避免了 MSVC 需要。

在旧版 MSYS2（安装在 D 盘）中，由于自带的 Rust 版本较旧以及 PATH 环境变量的限制，导致了构建 Rust 依赖失败的问题。通过手动下载安装 Rustup，并在 MSYS2 中调整 PATH 变量，让系统使用 Rustup 管理的新工具链，最终成功升级到 Rust 1.87.0，从而解决了编译依赖的问题。这份笔记记录了整个处理过程和关键步骤，供未来参考和类似环境下的故障排查使用。如果今后遇到其它问题，也可以依此方法进行详细的排查和处理。

如果在后续使用过程中出现新的问题，可以随时参考这些步骤进行排查！经过这些步骤，MSYS2 运行 Rust 和 Cargo 的环境已经正确配置，环境中使用 Rust 和 Cargo，可能会遇到。以下是解决该问题的详细过程和关键步骤。安装完成后，再次检查 Rust 版本是否正确。，否则 Cargo 相关工具可能无法运行。作为依赖项，如果没有安装该库，可能会导致。需要更高版本的 Rust（如。如果所有包都是最新的，则说明。已成功安装并可以正常运行！在 Windows 的。中执行以下命令，检查。

工作记录。

通过重装历史版本 MSYS2 实现 Python 降级是当前最可靠的方案，核心在于精准匹配 Python 版本对应的安装包发布周期。操作时需严格验证安装包来源及版本信息，确保环境稳定适配项目需求。后续若需升级或降级 Python 版本，可重复此流程安装更高版本的 MSYS2 环境。

工作记录，下面是为该环境准备的最全工具链安装命令（包括 C/C++、Python、pip/wheel、GTK3/GTK4、PyGObject、Cairo、SDL2 等）。这一环境适用于构建原生 64 位 Windows 应用程序。

Virtualenv（.venv）方案：存在“Poetry 环境脱离项目目录”与“Windows 下 GTK 依赖缺失”两大问题，无法完成部署。Poetry 原生方案Python 3.12/3.11 + Poetry（项目目录）：只解决了环境位置可控，但依旧因 GTK 缺失或后端包兼容问题导致部署失败。：利用 MSYS2 的pacman安装 GTK/cairo、Node.js、make、工具链，最终前后端部署都成功，是目前唯一可行方案。部署优先级Docker 部署（一键容器化）——最省心；

在 Python 3.12+ 虚拟环境中安装tokenizers库时，我们可能会遇到pip install tokenizers安装失败和找不到适配版本的公开whl文件，从而导致tokenizers库缺失的问题。经过探索，我们找到了一种可行的解决方案，尝试通过命令下载兼容版本，再进行本地安装。

通过以上流程，可系统性完成 Suna 在 Windows 的部署，结合专栏中的具体问题排查案例，能有效避开环境兼容、依赖缺失、配置错误等核心坑点。因篇幅有限，所有涉及处理步骤的详细处理办法请参考文末资料。指定 MSYS2 的 Python（如。：若用系统默认 Python，需通过。F:\项目\suna。docker 未运行。

在基于 MSYS2（MINGW64）中 Python 创建的 Poetry 虚拟环境里，安装 Suna 开源项目相关包时编译失败，阻碍项目正常部署。文件夹 ），复制这些文件夹到 MSYS2（MINGW64）的 Poetry 虚拟环境的。新建相同 Python 版本虚拟环境，在新环境中安装相关包。目录下，搜索已安装包的所有文件夹（包括包文件夹及其对应的。目录中，从而让 Suna 项目能正常部署。然后在新环境文件夹的。

所有其它包已经是最新版本。✅ 总共安装了3 个新包，并确认其余包已存在且是最新的。

✅ 所有依赖都已满足，并且cmake成功安装！

✅ 所有目标包都已成功重新安装或确认是最新的。

numpynumpy。

项目MINGW64 环境Clang64 环境终端名称Python 路径包名前缀是否适合你？✅ 若使用默认开发环境✅ 若用于跨平台编译是否支持降级✅ 加参数即可✅ 同样需要加参数。

⚠️ 如果遇到 pacman 拒绝降级，则在包名前加上“

mesonmeson。

关键点说明包命名规则根据功能区分python-前缀的使用隐含依赖安装时会自动拉取meson和推荐环境使用官方 Python 环境避免构建问题验证命令检查cythonninjameson的版本号。

Maturin是一个用于构建和发布 Python 包的工具，特别适用于使用Rust编写的 Python 扩展模块。它简化了将 Rust 代码编译为 Python 可用的.whl包的过程。构建wheel包支持支持交叉编译支持上传到 PyPI 或私有仓库工具是否成功版本号备注maturin✅ 成功1.8.6通过 pacman 安装，集成 Rust 和 Python 开发支持。

工具是否成功版本号备注pipx❌ 失败N/A与 pip 安装的库冲突numpy✅ 成功2.2.6-1重新安装pip✅ 成功25.1.1-1重新安装setuptools✅ 成功78.1.0-1重新安装wheel✅ 成功0.45.1-1正常安装。

通过基于 MSYS2（MINGW64）的 Poetry 虚拟环境解决suna部署的前端库的安装问题

步骤关键点使用 MSYS2 MINGW64提供完整的 GTK 库支持使用 Poetry 管理虚拟环境实现依赖隔离与精准控制指定 MINGW64 的 Python 解释器确保能找到 GTK 动态库测试 GTK 加载快速验证环境是否配置成功通过上述方法，我们成功地绕过了 Windows 系统下因 GTK 库找不到而导致的前端安装失败问题，为顺利部署 SUNA 类似的开源 AI Agent 项目提供了稳定可靠的解决方案。

请确保妥善保存获取到的 API key，不要泄露给他人，以免造成安全问题。

工作记录。

在 MSYS2（MINGW64）中安装 Poetry 时，应优先使用pacman命令来确保系统的稳定性和兼容性。直接使用pip安装可能会带来不必要的麻烦和风险。

工作记录。

工作记录。