下载
概述
标准安装选项
最新的 stable 版本是 4.1 TBA (发行说明)。
Windows
Windows 安装包基于 Python 3.13,仅适用于 64 位系统。安装程序包和 .zip
包功能相同,只是安装方式不同。大多数用户下载安装程序包(绿色按钮)。
OpenSesame 在 Windows 11 上开发和测试。在其他版本的 Windows 上体验可能会有所不同。
Mac OS
OpenSesame 4.1 的 Mac OS 安装包尚未发布。下面的下载链接指向 4.0 版本。
Linux / Ubuntu
将下面的命令复制粘贴到终端。这将下载并运行一个安装脚本。该安装脚本需要 curl 和 virtualenv。在 Ubuntu 上,可以使用 sudo apt install curl python3-venv
进行安装。
bash <(curl -L https://github.com/open-cogsci/OpenSesame/raw/refs/heads/4.1/linux-installer.sh) --install
OpenSesame 在 Ubuntu 24.04 上开发和测试。在其他 Linux 发行版或其他 Ubuntu 版本上的使用体验可能会不同。
高级安装选项
PyPi(跨平台)
所有安装包都可用 pip 安装。请注意,在 PyPi 上 OpenSesame 的名称为 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
Expyriment 用于 xpyriment 后端
pip install http://files.cogsci.nl/expyriment-0.10.0+opensesame2-py3-none-any.whl
安装所有包后,只需运行以下命令即可启动 OpenSesame:
opensesame
对于 Sigmund Analyst(代码编辑器):
sigmund-analyst
Anaconda(跨平台)
首先,为 OpenSesame 创建一个新的 Python 环境(可选):
conda create -n opensesame-41 python=3.13
conda activate opensesame-41
然后,按照上方 PyPi 安装说明操作。不再单独提供 Anaconda 安装包。
旧版本
旧版本可从 GitHub 发布页面下载:
源代码
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)以修复主要 bug。因此,如果你是在不经常更新的软件环境中安装 OpenSesame,最好等到第二或第三个维护版本(例如 3.0.2、3.1.3 等)再安装。这样可以最大程度降低部署含有严重 bug 的 OpenSesame 版本的风险。
- Windows 安装程序支持使用
/S
标志进行静默安装。