下载
概述
标准安装选项
最新的 stable 版本为 4.1 Neonatal Nightingale(发行说明)。
Windows
大多数用户会下载 .exe
安装包。如果您没有管理员权限,或者需要同时运行多个 OpenSesame 版本,请下载 .zip
包。
基于 Python 3.13,适用于 64 位系统。在 Windows 11 上测试通过。
部分外部设备,如 EyeLink 和 Tobii 眼动仪,需要不同版本的 Python。更多信息请参阅相关文档页面。
Mac OS
首次启动 OpenSesame 时,系统会因为应用不来自受信任的开发者而阻止其运行。您可以在“设置 > 隐私与安全”下找到“仍要打开”选项。当应用被阻止后,此选项才会出现。
基于 Python 3.13,适用于 64 位 Intel 系统。在 Mac OS X Sequoia 上测试通过。
部分外部设备,如 EyeLink 和 Tobii 眼动仪,需要不同版本的 Python。更多信息请参阅相关文档页面。
Linux / Ubuntu
将以下命令复制粘贴到终端中。这将下载并运行安装脚本。
# 以下软件包需要在 Ubuntu 24.04 上安装。
# 其他 Linux 发行版需安装等效软件包。
sudo apt install curl python3-venv libxcb-cursor0
# 下载并运行 OpenSesame 安装脚本。
bash <(curl -L https://github.com/open-cogsci/OpenSesame/raw/refs/heads/4.1/linux-installer.sh) --install
已在 Ubuntu 24.04(Python 3.12)测试。
高级安装选项
PyPi(跨平台)
所有包均可通过 pip 安装。请注意,OpenSesame 在 PyPi 上名为 opensesame-core
。
OpenSesame 核心依赖:
pip install --pre opensesame-core opensesame-extension-sigmund opensesame-extension-osweb opensesame-extension-updater opensesame-plugin-psychopy opensesame-plugin-media_player_mpy pygame
PsychoPy 为(默认)psycho 后端。根据您的操作系统和 Python 版本,PsychoPy 可能不会正确安装。如果出现此问题,请在支持论坛寻求帮助或使用预制包/安装程序。
pip install psychopy psychopy_sounddevice psychopy_visionscience
用于眼动追踪的 PyGaze:
pip install https://github.com/smathot/PyGaze/releases/download/prerelease%2F0.8.0a3/python_pygaze-0.8.0a3-py3-none-any.whl
xpyriment 后端的 Expyriment
pip install http://files.cogsci.nl/expyriment-0.10.0+opensesame2-py3-none-any.whl
安装好全部包后,您只需要运行:
opensesame
或者对于 Sigmund Analyst(代码编辑器):
sigmund-analyst
Anaconda(跨平台)
首先,为 OpenSesame 创建一个新的 Python 环境(可选)
conda create -n opensesame-41 python=3.13
conda activate opensesame-41
接下来,按照上面的 PyPi 安装说明操作。不再提供专门的 Anaconda 安装包。
旧版本 OpenSesame 及其它 Python 版本
旧版本的 OpenSesame 以及基于不同 Python 版本(3.10、3.11 和 3.12)构建的软件包都可以在 GitHub releases 页面获取:
源代码
OpenSesame 的源代码可在 GitHub 获取。
提示
应该使用哪个版本的 Python?
OpenSesame 当前基于并经测试的 Python 版本是 3.13。其它 >=3.10 的 Python 版本也可以使用,但没有经过充分测试。Python 2 不再支持。最后一个包含 Python 2 软件包的版本为 3.3.12,可以在 release archive 下载。
什么时候(不)应该更新?
- 在开发和测试实验时请更新;使用 OpenSesame 的最新版本永远是最佳选择。
- 在运行实验时请勿更新,也就是说,在收集数据时不要更新。
- 运行实验时请使用与开发和测试时相同版本的 OpenSesame。
手动升级包
OpenSesame 是一个常规的 Python 环境,你可以在 Jupyter 控制台中运行 pip install
命令。
系统管理员提示
- 当 OpenSesame 发布新的主版本(版本号以 0 结尾,例如 3.1.0)时,通常很快会跟进一两个维护版本(例如 3.1.1 和 3.1.2),这些版本主要修复重大漏洞。因此,如果你需要在不经常更新的系统上安装 OpenSesame,建议等待第二或第三个维护版本(例如 3.0.2、3.1.3 等)再进行安装。这样可以最小化部署包含重大漏洞版本的风险。
- Windows 安装程序支持使用
/S
参数静默安装 OpenSesame。