Mac上安装运行SynthTIGER

1. 确保已安装 Python 环境

SynthTIGER 需要 Python 3.6+。如果你的 Mac 没有安装 Python:

验证安装:

复制代码
python3 --version
pip3 --version

2. 安装 SynthTIGER

通过 pip 安装 SynthTIGER:

复制代码
pip3 install synthtiger

(如果需要特定版本,可以指定版本号,如 pip3 install synthtiger==1.x.x


3. 验证安装

运行以下命令检查是否安装成功:

复制代码
python3 -c "import synthtiger; print(synthtiger.__version__)"

如果没有报错并显示版本号,说明安装成功。

  1. 常见问题

1.pip3 install synthtiger error: externally-managed-environment 错误

复制代码
pip3 install synthtiger error: externally-managed-environment × This environment is externally managed ╰─> To install Python packages system-wide, try brew install xyz, where xyz is the package you are trying to install.

这个错误是因为你的 macOS 系统(尤其是较新版本的 macOS,如 Ventura 或 Sonoma)默认使用 "externally-managed-environment" 机制,防止用户直接通过 pip 全局安装 Python 包,以避免与系统自带的 Python 冲突。

最佳实践是创建一个独立的 Python 虚拟环境(Virtual Environment):

复制代码
# 创建虚拟环境
python3 -m venv ~/synthtiger-env

# 激活虚拟环境
source ~/synthtiger-env/bin/activate

# 安装 SynthTIGER
pip install synthtiger

之后,每次运行 SynthTIGER 前,先激活虚拟环境:

复制代码
source ~/synthtiger-env/bin/activate
复制代码
2. AttributeError: `np.sctypes` was removed in the NumPy 2.0 release. Access dtypes explicitly instead. 错误
复制代码
python3 -c "import synthtiger; print(synthtiger.__version__)"
Traceback (most recent call last):
  File "<string>", line 1, in <module>
    import synthtiger; print(synthtiger.__version__)
    ^^^^^^^^^^^^^^^^^
  File "/synthtiger-env/lib/python3.13/site-packages/synthtiger/__init__.py", line 7, in <module>
    from synthtiger import components, layers, templates, utils
  File "/synthtiger-env/lib/python3.13/site-packages/synthtiger/components/__init__.py", line 11, in <module>
    from synthtiger.components.image_effect import *
  File "/synthtiger-env/lib/python3.13/site-packages/synthtiger/components/image_effect/__init__.py", line 7, in <module>
    from synthtiger.components.image_effect.additive_gaussian_noise import (
        AdditiveGaussianNoise,
.....
/synthtiger-env/lib/python3.13/site-packages/numpy/__init__.py", line 400, in __getattr__
    raise AttributeError(
    ...<3 lines>...
    )
AttributeError: `np.sctypes` was removed in the NumPy 2.0 release. Access dtypes explicitly instead.

1. 降级 NumPy(推荐)

最直接的解决方法是降级 NumPy 到 1.x 版本(兼容 imgaug):

复制代码
# 在虚拟环境中操作(确保已激活)
source ~/synthtiger-env/bin/activate

# 降级 NumPy
pip install "numpy<2.0" --force-reinstall

# 重新验证
python -c "import synthtiger; print(synthtiger.__version__)"

验证通过:

复制代码
python3 -c "import synthtiger; print(synthtiger.__version__)"
1.2.1
相关推荐
Java与Android技术栈10 小时前
macOS 为 Compose Desktop 构建跨平台图像库:OpenCV + libraw + libheif 实践
人工智能·opencv·macos·计算机视觉
CV-杨帆11 小时前
论文阅读:arxiv 2025 A Survey on Data Contamination for Large Language Models
论文阅读·人工智能·语言模型
布朗克16812 小时前
mac上的app如何自动分类
macos·apple·电脑使用技巧
Jamence12 小时前
多模态大语言模型arxiv论文略读(157)
论文阅读·人工智能·语言模型·自然语言处理·论文笔记
小白白白又白cdllp12 小时前
MAC安装虚拟机
macos
:-)12 小时前
mac上通过homebrew安装nvm管理多版本nodejs
linux·macos·编辑器·vim
秃头女孩y12 小时前
mac安装nvm执行命令报错-解决方案
macos·node.js·bash
真智AI12 小时前
全面安装指南:在Linux、Windows和macOS上部署Apache Cassandra
linux·windows·macos
快乐点吧12 小时前
【mac】快捷键使用指南
macos
kailp15 小时前
语言模型玩转3D生成:LLaMA-Mesh开源项目
人工智能·3d·ai·语言模型·llama·gpu算力